Karea MCP Server

Extensive MCP tools so Claude Code, Cursor, and other MCP clients can create, edit, close, recap, and link your dev tasks while you code. Per-task open questions, attached resources, Jira linking, productivity recap.

GitHub

Documentation

karea-mcp

The MCP server for Karea. 44 tools so Claude Code, Cursor, and any other MCP-compatible client can create, edit, close, recap, link, and otherwise manage your tasks while you code.

npm license

What you can do with it

  • Create / edit / close / delete tasks and subtasks from inside Claude Code while it codes
  • Read and write long-form markdown on any task (perfect for solution design + investigation notes)
  • Track open questions per task and answer them later
  • Attach resources (file references, links) to tasks
  • Link tasks to Jira and back
  • Get a productivity recap across a date range
  • Manage categories, projects, and project sharing

Install

npx karea-mcp

Configure (Claude Code)

Add to ~/.claude.json (or run claude mcp add):

{
  "mcpServers": {
    "karea": {
      "command": "npx",
      "args": ["-y", "karea-mcp"],
      "env": {
        "KAREA_API_KEY": "your_key_here",
        "KAREA_URL": "https://karea.app"
      }
    }
  }
}

Get your API key at https://karea.app/dashboard/settings/api-keys.

Configure (Cursor)

Add to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json globally:

{
  "mcpServers": {
    "karea": {
      "command": "npx",
      "args": ["-y", "karea-mcp"],
      "env": {
        "KAREA_API_KEY": "your_key_here"
      }
    }
  }
}

Tool catalogue

44 tools (regenerated by scripts/sync-metadata.mjs):

  • karea_add_note
  • karea_add_requisite
  • karea_answer_question
  • karea_ask
  • karea_close_task
  • karea_create_category
  • karea_create_project
  • karea_create_question
  • karea_create_resource
  • karea_create_subtask
  • karea_create_task
  • karea_delete_category
  • karea_delete_note
  • karea_delete_project
  • karea_delete_question
  • karea_delete_requisite
  • karea_delete_resource
  • karea_delete_task
  • karea_doing
  • karea_done
  • karea_edit_note
  • karea_edit_question
  • karea_edit_task
  • karea_get_jira_link
  • karea_get_markdown
  • karea_get_resource
  • karea_link_jira
  • karea_link_resource_to_task
  • karea_list_notes
  • karea_list_projects
  • karea_list_questions
  • karea_list_resources
  • karea_list_subtasks
  • karea_list_tasks
  • karea_quick_task
  • karea_recap
  • karea_set_markdown
  • karea_share_project
  • karea_toggle_requisite
  • karea_unlink_jira
  • karea_unlink_resource_from_task
  • karea_update_resource
  • karea_upload_resource
  • karea_view_task

Workflow example

You: I'm starting on the auth bug.
Claude (via karea-mcp): karea_doing("auth bug")
        --> status set to in_progress
You: Add a closing requisite: must pass the failing test.
Claude: karea_add_requisite(...)
You (later): I fixed it.
Claude: karea_toggle_requisite(...) then karea_done("auth bug")

License

MIT. See LICENSE.