Content
# karea-mcp
The MCP server for [Karea](https://karea.app). <!-- SYNC:TOOL_COUNT -->44<!-- /SYNC:TOOL_COUNT --> 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.
[](https://www.npmjs.com/package/karea-mcp)
[](https://github.com/starecz/karea-mcp/blob/main/LICENSE)
[](https://glama.ai/mcp/servers/starecz/karea-mcp)
## 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
```bash
npx karea-mcp
```
## Configure (Claude Code)
Add to `~/.claude.json` (or run `claude mcp add`):
```json
{
"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:
```json
{
"mcpServers": {
"karea": {
"command": "npx",
"args": ["-y", "karea-mcp"],
"env": {
"KAREA_API_KEY": "your_key_here"
}
}
}
}
```
## Tool catalogue
<!-- SYNC: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`
<!-- /SYNC:TOOL_CATALOGUE -->
## 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](https://github.com/starecz/karea-mcp/blob/main/LICENSE).
