Karea Mcp

io.github.starecz由 GitHub 账号 starecz 发布v0.15.0更新于 Nov 7, 2026

Karea task manager - 9 tools covering 70 actions, for Claude Code, Cursor, and other MCP clients.

概览

AI 生成的概览

Karea 任务管理器的 MCP 服务器,让助手读取、创建、编辑、关闭和删除 Karea 工作区中的任务、笔记、会议与资源。

可以做什么
  • 读取项目、任务、子任务、笔记、便签、任务 Markdown、问题、资源、会议、提醒、Jira 关联和活动回顾
  • 创建、编辑和关闭任务与子任务,记录进行中或已完成的工作,管理关闭前置条件
  • 添加和编辑笔记、便签、任务 Markdown 文档与 AI 上下文条目
  • 创建项目和分类、通过邮件共享项目,并管理会议、议程条目、问题与提醒
  • 创建、上传和更新资源,将其附加到任务,并把任务关联到 Jira 问题或 AI 编码会话
  • 删除或解除关联,向 Karea AI 助手发送自然语言请求,并查询任意操作的参数结构
适用场景
适合在使用 Karea 时让助手在编码或排查过程中同步任务状态:记录进展、保存笔记与待解决问题,并按日期范围回顾工作。适用于 Claude Code、Cursor 等 MCP 客户端,而非一般聊天场景。
运行要求
通过 npx karea-mcp 以 stdio 在本地运行,需要 Node.js。需要 Karea 账号,并在 KAREA_API_KEY 环境变量中提供 API 密钥;KAREA_URL 可选,用于覆盖默认的托管服务地址。需要能访问 Karea 的网络。
安装前请注意
KAREA_API_KEY 中的 API 密钥可访问你的 Karea 工作区,应避免写入共享配置文件。写入类工具会改动真实数据:编辑会覆盖已有的笔记、Markdown 和上下文,删除为永久操作且部分需 confirm=true,共享项目会向他人发送邮件邀请。karea_assistant 操作可自行读取或修改任务,使用后应检查其改动。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Karea Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

karea-mcp

The MCP server for Karea. 9 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] [karea-mcp MCP server]

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?section=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

9 tools covering 70 actions (regenerated by scripts/sync-metadata.mjs).

Each tool takes an action and a params object. Actions are not tools: karea_list_notes is called as karea_read with { "action": "karea_list_notes", "params": { ... } } (the karea_ prefix of an action is optional). Set KAREA_MCP_LEGACY_TOOLS=1 to go back to registering all 70 actions as individual tools.

  • karea_read - Read anything in Karea without changing it: projects, tasks, subtasks, notes, sticky notes, task documents and AI context, open questions, resources, meetings, reminders, Jira links, AI sessions, and the activity recap. The main entry point - start here.
    • karea_list_projects, karea_list_tasks, karea_view_task, karea_view_tasks, karea_task_changes, karea_list_subtasks, karea_list_notes, karea_list_sticky_notes, karea_get_markdown, karea_get_context, karea_list_questions, karea_list_resources, karea_get_resource, karea_list_meetings, karea_view_meeting, karea_check_reminders, karea_get_jira_link, karea_list_sessions, karea_recap
  • karea_tasks_write - Create and change tasks: create, edit one or many, close one or many, log finished or in-progress work, plus subtasks and closing requisites (the checklist a task needs before it can close).
    • karea_create_task, karea_quick_task, karea_doing, karea_edit_task, karea_edit_tasks, karea_close_task, karea_done, karea_create_subtask, karea_add_requisite, karea_toggle_requisite
  • karea_notes_write - Write notes: add or edit task notes (human-readable updates) and sticky notes, and write a task's markdown document or an entry of its AI Context (private cross-session memory). Overwrites what an edit replaces.
    • karea_add_note, karea_edit_note, karea_create_sticky_note, karea_edit_sticky_note, karea_set_markdown, karea_set_context
  • karea_projects_write - Create a project or a category inside one, or share a project with someone by email.
    • karea_create_project, karea_create_category, karea_share_project
  • karea_meetings_write - Create and edit meetings and put tasks or questions on their agenda; create, answer and edit open questions; create, snooze, dismiss or complete reminders.
    • karea_create_meeting, karea_edit_meeting, karea_link_task_to_meeting, karea_link_question_to_meeting, karea_create_question, karea_answer_question, karea_edit_question, karea_create_reminder, karea_snooze_reminder, karea_dismiss_reminder, karea_mark_reminder_done
  • karea_resources_write - Create, upload and update resources in the file/document library and attach them to tasks; link a task to a Jira issue or to an AI coding session.
    • karea_create_resource, karea_upload_resource, karea_update_resource, karea_link_resource_to_task, karea_link_jira, karea_link_session
  • karea_assistant - Send a natural-language request to the Karea AI assistant, which may read or change your tasks to carry it out.
    • karea_ask
  • karea_delete - Delete or detach things. Permanent deletes (project, category, task, requisite, note, sticky note, question, resource, meeting) need confirm=true where stated; detaching a resource, task, question, Jira issue or AI session from what it is linked to.
    • karea_delete_project, karea_delete_category, karea_delete_task, karea_delete_requisite, karea_delete_note, karea_delete_sticky_note, karea_delete_question, karea_delete_resource, karea_delete_meeting, karea_unlink_resource_from_task, karea_unlink_task_from_meeting, karea_unlink_question_from_meeting, karea_unlink_jira, karea_unlink_session
  • karea_help - full parameter schema for any action.

List actions need at least one filter, so a single call cannot dump everything you have:

ActionAccepted filters
karea_list_tasksprojectId, status, closedSince, category, priority, assignee, search
karea_list_questionsprojectId, status
karea_list_meetingsscope, from, to, projectId
karea_list_resourcesprojectId, query, folder, type, mime, minSize, maxSize
karea_list_sticky_notesprojectId, or scope (global / all)

A call without one is refused with the accepted filters listed, so the agent can retry at once. karea_list_projects needs none (it is how an agent finds the projectId), and neither do pending reminders in karea_check_reminders.

Workflow example

You: I'm starting on the auth bug.Claude (via karea-mcp): karea_doing("auth bug")        --> status set to in_progressYou: 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.

来源:README.md,提交 5c09210

工具

9

karea_read

Read from Karea

Actions of this tool: karea_list_projects, karea_list_tasks, karea_view_task, karea_view_tasks, karea_task_changes, karea_list_subtasks, karea_list_notes, karea_list_sticky_notes, karea_get_markdown, karea_get_context, karea_list_questions, karea_list_resources, karea_get_resource, karea_list_meetings, karea_view_meeting, karea_check_reminders, karea_get_jira_link, karea_list_sessions, karea_recap. These are actions, not tools: call karea_read with action="karea_list_projects" (or another name above) and its arguments in params; there is no tool named after an action. Read anything in Karea without changing it: projects, tasks, subtasks, notes, sticky notes, task documents and AI context, open questions, resources, meetings, reminders, Jira links, AI sessions, and the activity recap. The main entry point - start here. Pass one of these as `action`, with its arguments in `params`: - karea_list_projects - List all Karea projects with their IDs [no parameters] - karea_list_tasks - List tasks in a project. [optional: projectId, status, closedSince, limit, category, priority, assignee, search] - karea_view_task - Return one task with all its details (status, priority, deadline, recurrence, category, description, notes, requisites, links), located by visual ID, name or UUID. [required: task; optional: projectId, includeContext] - karea_view_tasks - Return details for MANY tasks in one response. [required: tasks; optional: projectId, includeContext, includeMarkdown] - karea_task_changes - Return only what changed on one task in the last sinceMinutes minutes (status, fields, notes with a short excerpt, Context entry titles, links...), each with who, how (user = browser, mcp = API/AI, jira, system) and when, newest first. [required: task, sinceMinutes; optional: projectId] - karea_list_subtasks - List subtasks of a parent task. [required: parent; optional: projectId] - karea_list_notes - List the notes (human-readable updates) on a task, newest first. [required: task; opti

输入参数actionparams

karea_tasks_write

Create and update tasks

Actions of this tool: karea_create_task, karea_quick_task, karea_doing, karea_edit_task, karea_edit_tasks, karea_close_task, karea_done, karea_create_subtask, karea_add_requisite, karea_toggle_requisite. These are actions, not tools: call karea_tasks_write with action="karea_create_task" (or another name above) and its arguments in params; there is no tool named after an action. Create and change tasks: create, edit one or many, close one or many, log finished or in-progress work, plus subtasks and closing requisites (the checklist a task needs before it can close). Pass one of these as `action`, with its arguments in `params`: - karea_create_task - Create a new task in a project and return it with its visual ID (e.g. [required: name; optional: category, priority, sla, description, markdown, source, closingRequisites, tags, parentId, jiraIssueKey, projectId, aiSessionId, toolType, sessionLabel] - karea_quick_task - Log something you already finished as a done task (it shows up in Recap) and return it. [required: description; optional: source, projectId, aiSessionId, toolType, sessionLabel] - karea_doing - Create a task you are working on right now (status: in_progress) [required: description; optional: category, priority, sla, projectId, aiSessionId, toolType, sessionLabel] - karea_edit_task - Update fields of an existing task (title, status, priority, deadline, category, description, tags, or add a note) located by visual ID, name or UUID. [required: task; optional: name, priority, status, closeSubtasks, reviewStage, sla, description, markdown, category, note, tags, clearTags, closingRequisites, clearClosingRequisites, jiraIssueKey, linkTasks, linkType, unlinkTasks, projectId, aiSessionId, toolType, sessionLabel] - karea_edit_tasks - Apply the SAME change to many tasks in ONE request - status, priority, category, deadline, assignee, or a note. [required: tasks; optional: projectId, status, priority, category, sla, note] - karea_close_task - Mark a task as done: s

输入参数actionparams

karea_notes_write

Write notes and task documents

Actions of this tool: karea_add_note, karea_edit_note, karea_create_sticky_note, karea_edit_sticky_note, karea_set_markdown, karea_set_context. These are actions, not tools: call karea_notes_write with action="karea_add_note" (or another name above) and its arguments in params; there is no tool named after an action. Write notes: add or edit task notes (human-readable updates) and sticky notes, and write a task's markdown document or an entry of its AI Context (private cross-session memory). Overwrites what an edit replaces. Pass one of these as `action`, with its arguments in `params`: - karea_add_note - Add a note to a task - or the same note to many tasks at once, via `tasks`. [required: content; optional: task, tasks, projectId, replyTo, aiSessionId, toolType, sessionLabel] - karea_edit_note - Change the text of an existing note on a task, by note ID, and return the updated note. [required: task, noteId, content; optional: projectId, aiSessionId, toolType, sessionLabel] - karea_create_sticky_note - Pin a short note to the user's sticky board - a command, a URL, a couple of lines to remember. [required: content; optional: title, color, projectId, pinned] - karea_edit_sticky_note - Change a sticky note: its text, title, colour, pin state, or which project it belongs to. [required: noteId; optional: content, title, color, projectId, pinned] - karea_set_markdown - Write the markdown document for a task. [required: task, markdown; optional: projectId, aiSessionId, toolType, sessionLabel] - karea_set_context - Write a titled entry of the task's Context - the AI-facing cross-session working memory. [required: task, context; optional: title, allowSimilarTitle, projectId, aiSessionId, toolType, sessionLabel] For the full parameter schema of any action, call karea_help with that action name.

输入参数actionparams

karea_projects_write

Create and share projects

Actions of this tool: karea_create_project, karea_create_category, karea_share_project. These are actions, not tools: call karea_projects_write with action="karea_create_project" (or another name above) and its arguments in params; there is no tool named after an action. Create a project or a category inside one, or share a project with someone by email. Pass one of these as `action`, with its arguments in `params`: - karea_create_project - Create a new Karea project owned by you and seed it with the default categories (Coding, Testing, Documenting, Reviewing). [required: name] - karea_create_category - Create a new category (a task bucket) inside an existing project and return it. [required: name; optional: projectId] - karea_share_project - Give another user access to a project by email at a chosen role (owner, editor, commenter or viewer). [required: project, email; optional: role] For the full parameter schema of any action, call karea_help with that action name.

输入参数actionparams

karea_meetings_write

Manage meetings, questions and reminders

Actions of this tool: karea_create_meeting, karea_edit_meeting, karea_link_task_to_meeting, karea_link_question_to_meeting, karea_create_question, karea_answer_question, karea_edit_question, karea_create_reminder, karea_snooze_reminder, karea_dismiss_reminder, karea_mark_reminder_done. These are actions, not tools: call karea_meetings_write with action="karea_create_meeting" (or another name above) and its arguments in params; there is no tool named after an action. Create and edit meetings and put tasks or questions on their agenda; create, answer and edit open questions; create, snooze, dismiss or complete reminders. Pass one of these as `action`, with its arguments in `params`: - karea_create_meeting - Create a meeting. [required: title, startAt, endAt; optional: description, location, projectId, notes, attendees] - karea_edit_meeting - Update a meeting. [required: meetingId; optional: title, startAt, endAt, description, location, projectId, notes, transcript] - karea_link_task_to_meeting - Link an EXISTING task to a meeting (discussed at / arising from it). [required: meetingId, task; optional: projectId] - karea_link_question_to_meeting - Link an EXISTING open question to a meeting, so it is raised there. [required: meetingId, questionId; optional: projectId] - karea_create_question - Create an open question (a decision or blocker to resolve) in a project, optionally linked to tasks, and return it with its short ID (e.g. [required: question; optional: projectId, markdown, taskIds] - karea_answer_question - Answer an open question, located by short ID or text match: sets its answer and flips its status to answered. [required: questionId, answer; optional: projectId] - karea_edit_question - Edit an open question: change its text, status (open, answered or cancelled), answer, or linked tasks. [required: questionId; optional: question, answer, status, markdown, taskIdsAdd, taskIdsRemove, projectId] - karea_create_reminder - Schedule a reminder on a task or on an

输入参数actionparams

karea_resources_write

Manage resources and integrations

Actions of this tool: karea_create_resource, karea_upload_resource, karea_update_resource, karea_link_resource_to_task, karea_link_jira, karea_link_session. These are actions, not tools: call karea_resources_write with action="karea_create_resource" (or another name above) and its arguments in params; there is no tool named after an action. Create, upload and update resources in the file/document library and attach them to tasks; link a task to a Jira issue or to an AI coding session. Pass one of these as `action`, with its arguments in `params`: - karea_create_resource - Create a text resource (a note or document) in a project or folder and return it with its ID. [required: name, content; optional: projectId, folder, task, taskId] - karea_upload_resource - Upload a file as a resource and return it with its ID. [optional: name, path, data, link, mimeType, folder, task, taskId, projectId] - karea_update_resource - Overwrite a text resource content and/or metadata, by ID, and return the updated resource. [required: resourceId; optional: name, content, folder] - karea_link_resource_to_task - Link an existing resource (text or file) to a task. [required: resourceId, task; optional: projectId] - karea_link_jira - Link a Karea task to a JIRA issue by issue key (e.g. [required: task, issueKey; optional: projectId] - karea_link_session - Link your current AI coding session (Claude Code, OpenCode, Codex, Cursor, Aider) to a Karea task so the user can see the session history for that task and copy a command to resume the session later. [required: task, provider, sessionId; optional: label, projectId] For the full parameter schema of any action, call karea_help with that action name.

输入参数actionparams

karea_assistant

Ask the Karea AI assistant

Actions of this tool: karea_ask. These are actions, not tools: call karea_assistant with action="karea_ask" (or another name above) and its arguments in params; there is no tool named after an action. Send a natural-language request to the Karea AI assistant, which may read or change your tasks to carry it out. Pass one of these as `action`, with its arguments in `params`: - karea_ask - Send a natural-language request to the Karea AI assistant, which may read or modify your tasks to carry it out, and return its reply. [required: message; optional: projectId] For the full parameter schema of any action, call karea_help with that action name.

输入参数actionparams

karea_delete

Delete or unlink in Karea

Actions of this tool: karea_delete_project, karea_delete_category, karea_delete_task, karea_delete_requisite, karea_delete_note, karea_delete_sticky_note, karea_delete_question, karea_delete_resource, karea_delete_meeting, karea_unlink_resource_from_task, karea_unlink_task_from_meeting, karea_unlink_question_from_meeting, karea_unlink_jira, karea_unlink_session. These are actions, not tools: call karea_delete with action="karea_delete_project" (or another name above) and its arguments in params; there is no tool named after an action. Delete or detach things. Permanent deletes (project, category, task, requisite, note, sticky note, question, resource, meeting) need confirm=true where stated; detaching a resource, task, question, Jira issue or AI session from what it is linked to. Pass one of these as `action`, with its arguments in `params`: - karea_delete_project - Permanently delete a project and everything inside it (tasks, categories, notes, history). [required: name; optional: confirm] - karea_delete_category - Permanently delete a category AND every task inside it, including history. [required: name; optional: projectId] - karea_delete_task - Permanently delete a task and its history. [required: task; optional: confirm, projectId] - karea_delete_requisite - Permanently delete a closing requisite from a task, by ID. [required: task, requisiteId; optional: projectId] - karea_delete_note - Permanently delete a note from a task, by note ID. [required: task, noteId; optional: projectId] - karea_delete_sticky_note - Delete a sticky note. [required: noteId] - karea_delete_question - Permanently delete an open question. [required: questionId; optional: projectId] - karea_delete_resource - Permanently delete a resource (text or file) by ID. [required: resourceId] - karea_delete_meeting - Delete a meeting permanently. [required: meetingId, confirm] - karea_unlink_resource_from_task - Remove the link between a resource and a task. [required: resourceId, task; optional:

输入参数actionparams

karea_help

Karea action help

Return the full parameter list and description of any Karea action, and which tool to call it through. Read-only; changes nothing. Omit `action` to list every action grouped by tool. Actions are not tools: an action such as karea_list_notes is called as karea_read { action: "karea_list_notes", params: {...} }.

输入参数action

版本历史

6
  1. v0.15.0最新Oct 31, 2026
  2. v0.14.0Oct 24, 2026
  3. v0.13.0Oct 10, 2026
  4. v0.12.0Oct 9, 2026
  5. v0.10.0Sep 22, 2026
  6. v0.6.1Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分