Summary

Two places to write, and the difference between them is the point.

karea_set_markdown is the document a person reads; karea_set_context is working memory for whichever agent picks the task up next. Keeping them apart is what stops a task page turning into a transcript — and closing requisites let karea_close_task refuse to pretend the work is finished.

What it is

The MCP server for Karea. It creates and closes tasks with short visual IDs, keeps both a long-form markdown document and a separate AI-facing context per task, tracks open questions, links coding sessions to the task they belong to, and produces a recap of what actually happened.

What you get

Tasks — karea_create_task, karea_edit_task, karea_close_task, karea_delete_task, karea_view_task, karea_view_tasks for many at once, karea_list_tasks, karea_done for several in one call
Working state — karea_doing marks what you are on right now, karea_quick_task logs something already finished, karea_recap summarises recent activity
Structure — karea_create_project, karea_delete_project, karea_create_category, karea_delete_category, karea_create_subtask, karea_list_subtasks, karea_share_project by email and role
Closing requisites — karea_add_requisite, karea_toggle_requisite, karea_delete_requisite, with karea_close_task reporting any that are still unmet
Knowledge per task — karea_get_markdown and karea_set_markdown for the human-facing document, karea_get_context and karea_set_context for cross-session AI working memory, plus karea_add_note, karea_edit_note, karea_delete_note and karea_list_notes
Open questions — karea_create_question, karea_list_questions, karea_answer_question, karea_edit_question, karea_delete_question
Resources — karea_create_resource, karea_get_resource, karea_update_resource, karea_upload_resource for binary files, karea_list_resources, karea_link_resource_to_task, karea_unlink_resource_from_task, karea_delete_resource
Sessions and Jira — karea_link_session ties a Claude Code, OpenCode, Codex, Cursor or Aider session to a task, with karea_list_sessions and karea_unlink_session; karea_link_jira, karea_get_jira_link, karea_unlink_jira
karea_ask sends a natural-language request to the Karea assistant, which may read or modify tasks to carry it out

Requirements

The npm package karea-mcp over stdio, with KAREA_API_KEY in the environment; keys come from karea.app under dashboard settings. KAREA_URL defaults to https://karea.app for the hosted service. The destructive calls — karea_delete_task, karea_delete_project, karea_delete_category — require confirm=true and cannot be undone.

Setup effort

One command plus a key — npx karea-mcp, then supply credentials