关联 Todoist MCP(模型上下文协议)服务器到 Claude Code来直接从终端管理任务。关联后,您无需离开编码环境即可创建、阅读和更新 Todoist 任务和项目,这有助于您在跟进工作时保持专注。
您还可以通过 Claude 中的 Todoist 连接器将 Todoist 关联到 Claude,以实现聊天为主的工作流程。关联后,Claude 可以 阅读、创建 和 更新 您的 Todoist 任务 和 项目。有关说明,请参阅通过 Claude 使用 Todoist。
查看具体要求
- Claude 付费方案——Pro、Max、Team、Enterprise 或 Console。免费的 Claude.ai 方案不包括 Claude Code 访问。
- Claude Code 已安装并在您的机器上完成身份验证。
- 您将通过 OAuth 登录,这可以授权 Claude Code 通过 Todoist 官方 MCP 服务器访问 Todoist。
在 Claude Code 中建立 Todoist MCP
1. 添加 Todoist MCP 服务器
打开您的终端并运行以下命令:
claude mcp add --transport http Todoist https://ai.todoist.net/mcp
2. 确认服务器已添加
命令完成后,您将在终端中看到以下响应:
1 个 MCP 服务器需要授权 · /mcp这表示 Todoist MCP 服务器已确认添加,正等待您的授权。
3. 打开 MCP 服务器列表
在同一个终端中,输入 /mcp 并按下 Enter 键。这将打开所有已安装的 MCP 服务器列表,包括新添加的 Todoist 服务器。
4. 选择 Todoist 服务器
使用 ↑ 和 ↓ 箭头键导航到列表中的 Todoist,然后按 Enter。
5. 完成授权流程
按照屏幕提示登录您的 Todoist 账户,并授予 Claude Code 必要的权限。
授权后,Todoist 即可在 Claude Code 中使用。
Claude Code 将拥有哪些访问权限
关联后,Claude Code 可以使用 Todoist MCP 服务器来:
- 阅读您的 Todoist 任务和项目
- 创建任务和项目
- 更新任务和项目(例如:重命名、重新安排或移动到其他项目)
警告
您可以执行的操作示例
关联后,以下是一些效果不错的提示语:
| 目录 | 示例提示语 |
|---|---|
| 在代码中记录任务 | 在 Todoist 中添加任务:“修复 login.js 中的身份验证程序错误”,并将其放入工程项目中。 创建任务“为付款模块编写单元测试”,并将其截止日期设置为本周五。 |
| 规划工作 | 列出我所有过期的 Todoist 任务,并帮助我决定今天处理哪些。 显示本周所有到期任务,并建议我能实际完成哪些。 |
| 整理收件箱 | 整理我的 Todoist 收件箱,将每个条目转化为清晰、可操作的下一步。 将所有标记为“等待中”的任务移动到“等待处理”版块,并添加一个下周一的跟进任务。 |
| 保持专注 | 我正在开发结算功能——请检查 Todoist,告诉我是否有任何相关的未完成任务。 将此文件中的每个待办评论都添加为任务,并将它们全部放入当前冲刺项目中。 |
隐私和数据处理
当您通过 MCP 关联 Todoist 时,您的任务数据会与 Todoist 的服务器和 Claude 共享。Todoist 端的数据处理受 Todoist 隐私保护政策的约束;进入 Claude 上下文的数据(您的任务、项目等)也受 Anthropic 隐私保护政策的约束。
为了更加安心,您可以随时访问 Todoist 的 设置 > 关联应用,检查您已授予的权限。
取消关联 Todoist MCP
您可以在两个地方取消关联:
- 在 Claude Code 中:在终端中运行
claude mcp remove todoist以移除服务器。 - 在 Todoist 中:前往设置 > 关联应用撤销 Claude Code 的访问权限。
检修故障
claude mcp add 命令无法识别
请确保 Claude Code 已安装并保持最新。有关安装说明,请参阅 Claude Code 文档。
OAuth 浏览器窗口未打开
请再次运行 Claude Code 命令。如果窗口仍未出现,请检查您的浏览器是否阻止了弹出窗口,然后重试。
服务器显示在 Claude MCP 列表中,但 Todoist 工具不可用
添加服务器后,请启动新的 Claude Code 会话。MCP 服务器仅在会话启动时加载,因此现有的会话不会接收新连接。
报告程序错误或请求功能
Todoist MCP 服务器是开源代码。您可以在官方的 GitHub 上的 Todoist AI 存储库 中报告程序错误、请求功能或浏览已知问题。
联系我们
如果您对关联Todoist MCP 到 Claude Code 有疑问,或想了解更多信息,请联系我们。