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 分