Kaneo

io.github.usekaneo由 GitHub 账号 usekaneo 发布v0.1.14更新于 Oct 26, 2026

Official MCP server for Kaneo: manage tasks, projects, and labels from Claude and other MCP clients

已验证STDIO仅桌面效率与工作流开发者工具

概览

AI 生成的概览

Kaneo 官方 MCP 服务器，让助手管理 Kaneo 的任务、项目、标签、评论、关联与工时记录。

可以做什么
  • 查询当前登录用户、工作区、项目、项目列与自定义字段定义
  • 列出、搜索、创建、更新、复制、移动和删除任务，包括状态、负责人与截止日期
  • 管理任务评论、标签，以及子任务、阻塞、相关等任务关联
  • 读取并设置任务的自定义字段值
  • 记录、列出和更新工时条目，并查看任务的活动历史
适用场景
当团队用 Kaneo（云端或自托管）跟踪工作时，可让助手在聊天客户端中直接读取、创建或更新任务、评论、标签和工时，而不必打开网页界面。
运行要求
通过 npm 包 @kaneo/mcp 以 stdio 在本地运行，需要 Node.js。需要可访问的 Kaneo API：KANEO_API_URL 默认 KANEO_API_KEY，省略该密钥时走交互式设备授权流程。
安装前请注意
该服务器可创建、更新、移动和删除任务、评论、标签与关联，并记录工时，改动会直接影响真实团队数据。它持有 Kaneo API 密钥（KANEO_API_KEY），具备登录用户对工作区和项目的访问权限，请勿放入共享配置。若把 KANEO_API_URL 指向远程主机，任务数据会发送到该服务器。

安装

在 SourceWeft 中

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

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

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[Kaneo's logo]

Project management that doesn't become the project.

[Kaneo project board with the Kaneo logo and tagline]

Built for your team's work

  • See work your way: Board, List, Calendar, and Gantt views, plus a backlog, filters, and search.
  • Keep task context together: descriptions, attachments, subtasks, dependencies, labels, comments, and time tracking.
  • Work with your team: shared workspaces, invitations, custom roles, live updates, and public project views.
  • Shape your workflow: custom columns and fields, with rules that move tasks when repository activity changes.
  • Stay informed: in-app notifications, email, ntfy, Gotify, and personal webhooks.
  • Connect other tools: GitHub and Gitea, chat integrations, project webhooks, a REST API, a command-line client, and MCP for AI assistants.

Installation

Contributing

Code, translations, documentation, and bug reports are welcome. Start with the contributing guide and local development setup. Pay particular attention to contribution eligibility.

Join us on Discord, report bugs in GitHub Issues, or submit and vote on feature requests at Kaneo Feedback.

Sponsors

Kaneo is open source. If you find it useful, consider sponsoring the project to help support ongoing development.

Partners

[CI powered by Blacksmith]

This project is tested with BrowserStack.

Community sponsors

[User avatar: Daniel Sada][User avatar: (justin)randoneering][User avatar: Ryan Ilano][User avatar: Blendbyte]

License

MIT License - see LICENSE for details.

Built with ❤️ by the Kaneo team and contributors

来源：README.md，提交 dd92f6b

工具

41

whoami

Return the current Kaneo user for the configured authentication method.

无需输入参数。

list_workspaces

List workspaces (Better Auth organizations) the signed-in user can access.

无需输入参数。

list_projects

List projects in a workspace.

输入参数workspaceId必填includeArchived

get_project

Get a single project by ID.

输入参数id必填

create_project

Create a project in a workspace.

输入参数icon必填name必填slug必填workspaceId必填

update_project

Update project metadata (PATCH-style: only provided fields are changed).

输入参数id必填iconnameslugisPublicdescription

list_tasks

List a bounded page of tasks for a project (50 by default, maximum 100). Use pagination.totalPages and page to retrieve the rest; filters and sorting apply before pagination. For every task page, also follow relatedPage through pagination.relatedTotalPages for complete labels, links and column metadata. Custom field values are not included; use get_task_custom_field_values.

输入参数pagelimitsortBystatusdueAfterprioritydueBeforeprojectId必填sortOrderassigneeIdrelatedPage

get_task

Get a task by ID. Custom field values are not included; use get_task_custom_field_values.

输入参数taskId必填

get_task_by_ticket_id

Get one task by its ticket ID (project key and number, e.g. KAN-12). If multiple accessible tasks share the ID, provide workspaceId or projectId.

输入参数ticketId必填projectIdworkspaceId

create_task

Create a task in a project.

输入参数title必填status必填userIddueDatepriority必填projectId必填startDatedescription必填

duplicate_task

Duplicate a task in the same project, copying its fields and labels. Pass title to rename the copy.

输入参数titletaskId必填

update_task

Update a task (fetches current task, merges fields, then full update).

输入参数titlestatustaskId必填userIddueDatepositionpriorityprojectIdstartDatedescription

move_task

Move a task to another project (and optional column status).

输入参数taskId必填destinationStatusdestinationProjectId必填

update_task_status

Update only the status (column) of a task.

输入参数status必填taskId必填

list_task_comments

List comments on a task.

输入参数taskId必填

create_task_comment

Add a comment to a task.

输入参数taskId必填content必填

update_task_comment

Update one of your comments on a task.

输入参数content必填commentId必填

delete_task_comment

Delete one of your comments from a task.

输入参数commentId必填

list_workspace_labels

List labels defined in a workspace.

输入参数workspaceId必填

create_label

Create a label in a workspace (optionally attach to a task).

输入参数name必填color必填taskIdworkspaceId必填

attach_label_to_task

Attach an existing label to a task.

输入参数taskId必填labelId必填

detach_label_from_task

Detach a label from its current task.

输入参数labelId必填

create_task_relation

Create a relation between two tasks. relationType: 'subtask' (sourceTaskId is the parent, targetTaskId the child), 'blocks' (sourceTaskId blocks targetTaskId), or 'related' (bidirectional).

输入参数relationType必填sourceTaskId必填targetTaskId必填

get_task_relations

List all relations (subtask/blocks/related) involving a task.

输入参数taskId必填

delete_task_relation

Delete a task relation by its relation ID.

输入参数id必填

delete_label

Delete a task or workspace label by ID. Workspace-label cascades resume automatically; repeat the tool if pendingDeletion remains true.

输入参数id必填

list_workspace_members

List the members of a workspace. Use this to resolve the user ID an assignee tool expects.

输入参数workspaceId必填

list_project_columns

List a project's columns. Their slugs are the values update_task_status and create_task accept as a status.

输入参数projectId必填

list_project_custom_fields

List a project's custom field definitions: id, name, type (text, number, date, dropdown, boolean, multiselect), required, options, and defaultValue.

输入参数projectId必填

get_task_custom_field_values

List a task's custom field values with each field's name, type, and options. Fields without a value are omitted. Multiselect values are JSON array strings.

输入参数taskId必填

set_task_custom_field_value

Set or clear one custom field value on a task. Get fieldId from list_project_custom_fields. Pass dates as YYYY-MM-DD, a dropdown value as one of its options, multiselect values as an array of options, and null to clear the value (required fields can't be cleared).

输入参数value必填taskId必填fieldId必填

delete_task

Delete a task by ID.

输入参数taskId必填

update_task_assignee

Assign a task to a workspace member, or pass a null userId to unassign it.

输入参数taskId必填userId必填

update_task_due_date

Set a task's due date. Omit dueDate to clear it.

输入参数taskId必填dueDate

list_task_time_entries

List the time entries logged against a task.

输入参数taskId必填

get_time_entry

Get a single time entry by ID.

输入参数id必填

create_time_entry

Log time against a task. Omit endTime to leave the entry running.

输入参数taskId必填endTimestartTime必填description

update_time_entry

Update a time entry. startTime is required; omitting endTime keeps the stored one. startTime cannot be later than the end time.

输入参数id必填endTimestartTime必填description

list_task_activity

List a task's activity history.

输入参数taskId必填

list_notifications

List the signed-in user's notifications.

无需输入参数。

版本历史

4
  1. v0.1.14最新Oct 26, 2026
  2. v0.1.13Oct 9, 2026
  3. v0.1.12Oct 1, 2026
  4. v0.1.11Sep 16, 2026

评分

已满足适用检查项的 90%

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

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

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

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