适合谁
- 已在使用 Todoist 并希望用 AI 助手管理任务的 Claude Desktop / Cursor / Codex / Gemini CLI 用户
- 需要通过对话或筛选语言批量处理任务的用户
T
53FMRS · D
基于 README 的社区维护 MCP 服务器，完整覆盖 Todoist REST API v2 并支持 Sync API，工具覆盖任务、项目、分区、评论、标签，支持批量操作与自然语言交互。文档清晰，支持多种主流 MCP 客户端。适合重度 Todoist 用户，但需注意其非官方身份与 token 安全。
这是一个 Model Context Protocol (MCP) 服务器，由社区开发者维护，将 Claude 等 AI 助手与 Todoist 集成。它完整实现了 Todoist REST API v2，并支持 Sync API，允许用户用自然语言创建、更新、关闭、重开、移动和删除任务，管理项目、分区、评论和个人与共享标签。启动时会通过服务器指令自动向 AI 提供项目和标签上下文，并支持批量处理与按名称搜索。
工具能力
get_tasks_list
获取任务列表，可按项目、分区、标签或 ID 过滤
get_tasks_by_filter
使用 Todoist 筛选语言（如 today、overdue、P1 | P2）查询任务
create_tasks
创建新任务，支持多种属性
get_tasks
按 ID 或名称获取具体任务
update_tasks
更新现有任务
close_tasks
将任务标记为完成
reopen_tasks
重新打开已完成任务
delete_tasks
删除任务
move_tasks
将任务移动到其他项目或分区
get_projects_list
获取所有项目
create_projects
创建新项目
get_projects
按 ID 或名称获取具体项目
update_projects
更新现有项目
delete_projects
删除项目
get_collaborators
获取项目的所有协作者
move_projects
将项目移动到其他位置或作为子项目
get_sections_list
获取所有分区或按项目过滤
create_sections
创建新分区
get_sections
按 ID 或名称获取具体分区
update_sections
更新分区
delete_sections
删除分区
get_comments_list
获取项目或任务的评论
create_comments
创建新评论
get_comments
按 ID 获取具体评论
update_comments
更新评论
delete_comments
删除评论
get_labels_list
获取所有个人标签
create_labels
创建新个人标签
get_labels
按 ID 或名称获取个人标签
update_labels
更新个人标签
delete_labels
删除个人标签
get_shared_labels
获取所有共享标签
rename_shared_labels
重命名共享标签
remove_shared_labels
移除共享标签
utils_get_colors
获取项目、标签和筛选可用的颜色
projects_list
以 Markdown 格式获取项目及其分区的提示信息
安装接入
先在 Todoist 设置 → 集成 → Developer 中获取 API token，然后在 MCP 客户端配置的 mcpServers 中添加：command 为 npx，args 为 ["-y","todoist-mcp"]，env 中设置 API_KEY 为你的 Todoist API token。
claude_desktop_config.json
{"mcpServers":{"todoist":{"command":"npx","args":["-y","todoist-mcp"],"env":{"API_KEY":"your_todoist_api_token"}}}}
选型与风险
不适合谁
- 不使用 Todoist 的用户
- 需要官方 Todoist 支持或保证的用户（本项目为社区维护，MIT 许可）
所需权限
- 需要 Todoist API token，拥有该账户下任务、项目、分区、评论与标签的完整读写权限
风险与副作用
- API token 泄露可能导致任务数据被查看、修改或删除
- AI 误解指令可能误删或误改任务、项目
- 社区第三方项目，非 Todoist 官方维护
常见排障
- 确认 API_KEY 环境变量已设置为有效的 Todoist API token
- 在 Todoist 设置 → 集成 → Developer 中核对 token
- 确认已安装 Node.js 且 npx 可用
- 使用 @modelcontextprotocol/inspector 排查服务器连接问题
使用场景
用自然语言查询今天到期或高优先级的任务
对话式创建、完成或重开任务
管理项目、分区、评论与标签
使用 Todoist 筛选语言批量检索任务
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Cursor完整支持
Codex完整支持
Gemini CLI完整支持