适合谁
- 需要 AI 助手直接操作 Todoist 任务的用户。
- 希望在 Claude、Cursor、VS Code 等 AI 工具中无缝管理任务的开发者。
- 希望通过可复用工具构建自定义 AI 工作流的开发者。
T
40FMRS · D
Todoist MCP 服务器是官方维护的，提供可靠的任务管理集成。设计注重可复用性和完整工作流，而非零散的原子操作。支持多种主流客户端，安装配置简单。适合个人和开发者，但需注意权限和数据安全。
Todoist 官方提供的 MCP 服务器，允许 AI 代理代表用户访问和修改其 Todoist 账户。提供一组可复用的工具，支持通过 MCP 或直接集成到自定义 AI 对话界面。
工具能力
search
遵循 OpenAI MCP 规范，执行搜索操作，返回 JSON 编码结果。
fetch
遵循 OpenAI MCP 规范，获取指定内容，返回 JSON 编码结果。
findTasksByDate
根据日期查找任务。
addTasks
添加新任务。
other_tools_in_src_tools
更多工具位于 src/tools 目录，可查看完整列表。
安装接入
- 使用 npx 快速启动：
npx @doist/todoist-mcp - 对于 Claude Desktop：设置 → 连接器 → 添加自定义连接器，输入
https://ai.todoist.net/mcp并完成 OAuth 认证。 - 对于 Cursor：在
~/.cursor/mcp.json或项目.cursor/mcp.json中添加配置（见 install_config）。 - 对于 Claude Code：使用官方插件
/plugin marketplace add doist/todoist-mcp和/plugin install todoist@doist，或手动执行claude mcp add --transport http todoist https://ai.todoist.net/mcp。 - 对于 VS Code：命令面板 → MCP: Add Server，选择 HTTP 传输，使用提供的 JSON 配置。
- 其他客户端：运行
npx -y mcp-remote https://ai.todoist.net/mcp。
claude_desktop_config.json
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://ai.todoist.net/mcp"
]
}
}
}
选型与风险
不适合谁
- 不需要 AI 任务管理功能的用户。
- 需要多用户协作或权限管理功能的企业用户（该服务器仅操作单个用户账户）。
- 对数据隐私有严格要求的用户（可能需要评估第三方服务）。
所需权限
- 需要有效的 Todoist API 密钥（TODOIST_API_KEY）或通过 OAuth 认证。
- 工具可以读取和修改用户的 Todoist 账户数据，包括任务、项目和标签。
风险与副作用
- AI 代理可能意外删除或修改任务，建议使用测试账户或临时项目。
- API 密钥或 OAuth 令牌泄露可能导致账户被未授权访问。
- 由于依赖外部服务，可能存在服务中断或延迟。
常见排障
- 确保 TODOIST_API_KEY 设置正确，可使用 `npm run tool -- user-info '{}'` 验证连接账户。
- 检查网络连接和防火墙，确保能访问 `https://ai.todoist.net/mcp`。
- 对于写操作，先使用测试环境以避免意外数据修改。
使用场景
让 AI 助手帮助用户管理 Todoist 中的任务，如查找、创建、修改任务。
通过自然语言与 AI 对话来操作 Todoist 账户。
在自定义 AI 应用中集成 Todoist 工具，实现任务自动化。
支持客户端
Claude Desktop完整支持
Cursor完整支持
Claude Code (CLI)完整支持
Visual Studio Code完整支持
Other MCP Clients完整支持