task-board-todo-kanban

从 Claude 运行任务看板，使用免费的 MCP 看板服务

为每个项目创建任务看板，直接通过 AI 聊天操作。只需说“在 nova 网站看板上添加一个任务：撰写发布邮件，周五截止，90 分钟”，然后询问“nova 看板上有什么任务？”“有哪些任务已逾期？”或“规划我的一周”。每个任务包含标题、备注、标签、截止日期、预计用时、优先级和列（默认列为待办、待处理、进行中、审核中、已完成），并会获得一个简短且固定的 ID，例如 NS-12。任务还可以将其准确参数传递给时间追踪服务，让你花在任务上的时间计入同一个项目名称。所有数据都以纯 JSON 格式存储在你自己的计算机上。

由 theluckystrike 构建。

已收录于 官方 MCP 注册表（io.github.theluckystrike/kanban-todo-tasks-projects-board）。

每个项目都有一个本地看板，包含多个列、截止日期、预计用时和每周回顾；无需设置，所有数据均保存在本地。

60 秒安装

@theluckystrike/mcp-kanban 的 npm 发布尚待完成。在此之前，可使用 .mcpb 一键安装包，或克隆并构建；以下两种方式均已验证。

一键安装（.mcpb）：从最新版本下载 kanban.mcpb，然后在 Claude Desktop 中双击： https://github.com/theluckystrike/mcp-servers/releases/latest

（claude_desktop_config.json）：

{
  "mcpServers": {
    "kanban": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-kanban"]
    }
  }
}

Claude Code：

claude mcp add kanban -- npx -y @theluckystrike/mcp-kanban

（.cursor/mcp.json）：

{
  "mcpServers": {
    "kanban": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-kanban"]
    }
  }
}

上面的 npx 方式会在软件包发布后立即生效。在此之前，请使用上面的 .mcpb 安装包，或者严格按照以下三个命令从源代码构建：

git clone https://github.com/theluckystrike/mcp-servers.git && cd mcp-servers
npm install
npm run build -w packages/mcp-license -w servers/kanban

然后将客户端的 command 指向 node，并传入一个参数：servers/kanban/dist/index.js 的绝对路径。

若要使用 Pro 模式，请在同一配置块中设置 MCP_LICENSE_KEY，或使用你的密钥调用一次 license_activate。

工具

工具	功能
task_add	添加任务：包括标题，以及可选的项目、列、截止日期、预估时长、优先级、标签和备注。输入新项目名称会创建对应看板；如果部分名称恰好匹配一个现有项目，则使用该项目。
	截止日期可使用 YYYY-MM-DD、today、tomorrow、yesterday、+3d、星期几（friday，指从今天起最近的那个）和 next friday（再下一个星期五）。
task_list	任务表，可按项目、列、标签、due_before 或 overdue 筛选。除非你要求显示，否则会隐藏已完成的任务。默认显示 200 行，并说明还有多少行；可通过 limit 调高（最多 2,000）。
task_move	将任务移至其看板中的另一列。
task_update	修改任意字段：标题、备注、截止日期（none 可清除）、预估时长、优先级、标签、列或项目。
task_done	将任务标记为已完成：移至已完成列，并记录时间戳。
task_delete	删除任务。ID 不会重复使用。
	如果新任务与一个已存在的未完成任务完全相同（项目、标题、列、截止日期、预估时长、优先级、标签和备注均相同），则会拒绝添加，并指出已占用该位置的任务，而不会再写入一份副本。
task_search	在标题、备注、标签或 ID 中按文本查找任务。
board	按列汇总单个看板：任务数、预估时长总计、实际时长总计、逾期数量。
task_start_timer	返回此任务需传给时间追踪服务的 timer_start 的确切参数，并在任务上记录关联信息。
task_log_time	为任务添加实际工作分钟数，以便比较预估时长和实际时长。
project_list	列出所有看板及其未完成和已完成任务数、剩余预估时长和逾期数量。
project_delete	删除空看板并释放其项目名额。如果看板中仍有任务（未完成或已完成），则会拒绝删除并指出相关任务；请先用 task_delete 清除这些任务。
overdue	列出所有看板中已过截止日期的任务；as_of 可指定用另一天进行计算。
weekly_review	查看某周的已完成任务与计划任务，并按项目对比预估时长和实际时长。本周免费；过去的周需 Pro。
columns_set	替换某个看板的列（Pro）。被移除列中的任务会移至第一列。
license_status	查看 Free 或 Pro 许可，以及升级方式。
license_activate	激活 Pro 密钥（离线验证）。

此外还提供资源 kanban://today（今天到期的任务及所有逾期任务）和提示词 plan_week （将未完成的看板任务转为按天安排的计划，并控制在你实际可用的小时数内）。

你可以这样说

• “在 nova site 看板中添加一个任务：撰写发布邮件，周五到期，90 分钟，高优先级。”
• “将 NS-3 移至 doing。”
• “nova 看板是什么样的？”
• “有哪些任务逾期了？”
• “为 NS-3 启动计时器。”然后将返回的参数传给时间追踪服务。
• “我在 NS-3 上花了 40 分钟。”
• “每周回顾。”

Free 与 Pro

	Free	Pro
项目看板	3	无限
未完成任务	200	无限
列	默认的五列（backlog、todo、doing、review、done）	每个看板可自定义列（columns_set）
每周回顾	当前周	任意周，完整历史记录
预估与实际时长报告	仅当前周	每周均可
列表输出	每次调用 200 行，limit 最高为 2,000	相同
其他所有功能	包含	包含

Pro 为此服务一次性收费 $19，或为所有服务一次性收费 $39，终身使用。

获取 Pro：https://mcp.zovo.one/buy/kanban

搭配使用

• mcp-time-tracker：task_start_timer 会传入项目和任务名称，因此记录的工时会归入同一项目。
• mcp-calendar：在看板上查看截止日期，同时对照你本周的实际安排。
• mcp-invoice：将这些任务的追踪工时转换为发票明细。

隐私

所有数据都保留在本地的 ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/kanban/ 中。不会上传任何数据，无需账户，许可证密钥也会离线验证。

许可证

MIT。支持邮箱：[email protected]

常见问题

有 MCP 看板服务吗？

有。mcp.zovo.one 上的看板服务为 Claude 提供托管看板：可通过任何 MCP 客户端创建看板、列和卡片，以及在列之间移动卡片。与仅限本地的 GitHub 仓库不同，它是托管服务，而且可以免费开始使用——无需克隆或运行任何内容。

如何通过 Claude 管理看板？

连接 https://mcp.zovo.one/mcp/kanban，然后说：“创建一个包含待办、进行中、已完成三列的看板，并将一张名为设计落地页的卡片添加到待办列。”

将这些文档用作 MCP 服务

任何 MCP 客户端（Claude、Cursor、Windsurf、VS Code）都可以通过 GitMCP 直接读取此仓库的文档，无需安装：

• 文档 MCP URL：https://gitmcp.io/theluckystrike/mcp-kanban