Todoist MCP Server

什么是 Todoist MCP Server？

这个 Todoist MCP 服务器是由 abhiz123 开发的小型社区 MCP 服务器，把 Claude 连接到你的 Todoist 账号，使用 Todoist API token 认证后，就能用自然语言创建、列出、更新、完成和删除任务。

它通过 Node.js 在本地运行，以 @abhiz123/todoist-mcp-server 发布在 npm 上，提供五个任务工具。项目采用 MIT 许可证，并非 Todoist 背后的公司 Doist 出品。Doist 另外发布了带托管端点的官方 Todoist MCP 服务器，对比见下文。该社区仓库最后一次更新是在 2025 年 4 月。

如何使用 Todoist MCP Server？

前置条件：Node.js（用于 npx/npm）、一个 MCP 客户端，以及 Todoist API token。

获取 Todoist API token：

1. 登录 Todoist。
2. 进入 Settings > Integrations。
3. 在“Developer”部分复制你的 API token。

token 填入环境变量 TODOIST_API_TOKEN。持有该 token 的任何人都能操作你的 Todoist 账号，因此不要把它放进共享或提交到仓库的配置文件中。

Claude Desktop

把以下内容添加到 claude_desktop_config.json，然后重启 Claude Desktop：

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@abhiz123/todoist-mcp-server"],
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

也可以通过 Smithery 为 Claude Desktop 自动安装：

npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude

或者全局安装该包：

npm install -g @abhiz123/todoist-mcp-server

其他 MCP 客户端

README 只记录了 Claude Desktop。由于这是标准的 stdio 服务器，Cursor、VS Code 等客户端可以运行同样的 npx -y @abhiz123/todoist-mcp-server 命令，并在服务器的 env 块中设置 TODOIST_API_TOKEN。如果使用 Claude Code、Cursor 和 VS Code，官方 Doist 服务器（见下文）提供了有文档的配置步骤。

从源码构建

git clone https://github.com/abhiz123/todoist-mcp-server.git
cd todoist-mcp-server
npm install
npm run build

Todoist MCP Server 的主要功能

• 通过自然语言请求创建、更新、完成和删除 Todoist 任务。
• 智能任务搜索：更新、完成和删除操作会按任务名称的部分匹配查找任务，无需任务 ID。
• 按截止日期、优先级或项目筛选任务，支持自然语言日期筛选和可选的结果数量限制。
• 任务详情支持描述、截止日期和 1 到 4 级优先级。
• 每次操作后都有清晰的错误信息和确认反馈。
• 轻量且本地运行：一个 npm 包，一个环境变量。

Todoist MCP Server 工具

服务器提供五个工具，全部围绕任务：

• 创建：todoist_create_task，必填 content（标题），可选描述、截止日期和优先级。
• 读取：todoist_get_tasks，按截止日期、优先级或项目筛选任务，可设置数量上限。
• 修改：todoist_update_task，按部分名称找到任务，修改其内容、描述、截止日期或优先级。
• 完成或移除：todoist_complete_task 将匹配的任务标记为完成，todoist_delete_task 将其删除。

没有针对项目、标签、分区或评论的工具；仓库中有未关闭的 issue 请求增加项目支持。

Todoist MCP Server 的使用场景

• 在对话中随手记录任务：“Add task 'Review PR' due tomorrow at 2pm.”
• 规划一天：“列出今天到期的任务”，或“显示本周到期的高优先级任务”。
• 不打开应用就改期：“把文档任务改到下周到期。”
• 调整优先级：“把修复 bug 的任务改为紧急。”
• 收尾：“把 PR 评审任务标记为完成”，或“删除会议准备任务”。
• 把 Claude 刚总结好的会议纪要拆成一条条 Todoist 任务。

Todoist MCP Server 与替代方案对比

Doist 官方的 Todoist MCP server 托管在 https://ai.todoist.net/mcp（Streamable HTTP），通过 OAuth 登录，配置里不需要放 API token。它在积极维护中，文档覆盖 Claude Desktop、Claude Code（claude mcp add --transport http todoist https://ai.todoist.net/mcp）、Cursor 和 VS Code，也可以用 npx @doist/todoist-mcp 在本地运行。如果需要更广的功能覆盖和厂商支持，选择官方服务器；abhiz123 的服务器则适合只做基础任务管理、基于 token 的极简本地方案。团队项目管理工具可参考 Asana MCP Server 或 Trello MCP Server。

Todoist MCP Server 常见问题排查

• 认证错误：确认服务器的 env 块中设置了 TODOIST_API_TOKEN，且与 Settings > Integrations > Developer 中的 token 一致。
• 更新到了错误的任务：匹配基于部分名称，当多个任务名称相似时，请使用任务标题中更具体的部分。
• todoist_get_tasks 返回 400 错误：仓库的 issue 中有用户报告此问题。可以尝试更简单的筛选条件，或考虑使用积极维护的官方 Doist 服务器。
• Claude Desktop 中看不到服务器：检查 JSON 格式，确认已安装 Node.js 以便 npx 可用，然后完全重启 Claude Desktop。