适合谁
- 已在使用 Todoist 且希望通过 Claude 对话管理任务和项目的个人或团队用户
- 需要执行批量任务操作（如批量更新优先级、批量清理逾期任务）的用户
- 希望先用 Dry-Run 模式验证自动化脚本，再对真实数据执行操作的开发者
T
61FMRS · C
该项目是社区维护的 Todoist MCP 服务器，提供 19 个工具覆盖任务、项目、协作等全流程操作，并具备批量处理和 Dry-Run 演练模式等实用特性；仓库维护者对贡献流程和代码质量要求较为严格（例如要求单一关注点的 PR、真实 API 验证），文档详尽，但用户需自行承担 API 令牌管理和批量操作带来的数据变更风险。
一个开源的 MCP 服务器，将 Claude 与 Todoist 连接起来，通过自然语言实现完整的任务和项目管理。提供 19 个工具，覆盖任务、子任务、项目、版块、标签、评论、提醒、筛选器、协作、用户资料、活动日志、已完成任务、备份、笔记和工作区共享标签等功能，并支持批量操作和 Quick Add 自然语言解析。内置 Dry-Run（演练）模式，可在不实际修改 Todoist 数据的情况下验证操作。
工具能力
todoist_task
创建、查询、更新、删除、完成、重新打开任务，支持优先级、截止日期、标签及 Quick Add 自然语言解析
todoist_task_bulk
批量创建、更新、删除、完成多个任务，提升多任务处理效率
todoist_subtask
创建子任务、批量创建、转换为子任务、提升为主任务，并查看任务层级结构
todoist_project
项目的创建、查询、更新、删除、归档及协作者管理
todoist_project_ops
项目排序、移动到父项目、获取已归档项目等高级项目操作
todoist_section
版块的创建、查询、更新、删除、移动、排序和归档
todoist_label
标签的创建、查询、更新、删除及使用统计
todoist_comment
任务/项目评论的创建、查询、更新、删除
todoist_reminder
提醒（Pro 功能）的创建、查询、更新、删除
todoist_filter
自定义筛选器（Pro 功能）的创建、查询、更新、删除
todoist_collaboration
团队协作功能，包括邀请、通知和工作区操作
todoist_user
用户资料信息、生产力统计及成就（karma）历史
todoist_utility
连接测试、功能测试、性能测试及查找/合并重复项等实用工具
todoist_activity
获取活动日志、事件及活动摘要，用于审计追踪
todoist_task_ops
任务移动、排序、关闭等高级任务操作
todoist_completed
查询已完成任务、获取全部已完成任务及统计信息
todoist_backup
列出并下载 Todoist 自动生成的备份
todoist_notes
项目笔记（协作者可用）的创建、查询、更新、删除
todoist_shared_labels
工作区共享标签（Business 功能）的创建、查询、重命名、移除
安装接入
1）Claude Desktop 用户可从 GitHub 最新 Release 下载 todoist-mcp.mcpb 文件，双击或拖入 Claude Desktop 安装，随后输入 Todoist API 令牌即可使用；2）Claude Code 或其他 MCP 客户端可运行命令 claude mcp add todoist -e TODOIST_API_TOKEN=your_token -- npx @greirson/mcp-todoist；3）也可手动编辑 claude_desktop_config.json 或 ~/.claude.json，在 mcpServers 中添加 command 为 npx、args 为 ["@greirson/mcp-todoist"]、env 中设置 TODOIST_API_TOKEN 的配置；4）如需测试而不影响真实数据，可在 env 中额外添加 DRYRUN=true 启用演练模式。
claude_desktop_config.json
{"mcpServers":{"todoist":{"command":"npx","args":["@greirson/mcp-todoist"],"env":{"TODOIST_API_TOKEN":"your_api_token_here"}}}}
选型与风险
不适合谁
- 不使用 Todoist、或需要连接其他任务管理工具（如 Jira、Asana）的用户
- 需要官方 Todoist 出品或提供 SLA 支持保障的企业场景
- 不希望将 API 令牌和任务数据经由第三方 MCP 服务器处理的高度隐私敏感场景
所需权限
- 需要提供 Todoist 个人 API 令牌（在 Todoist 开发者设置中获取），该令牌授予账户级别的读写权限
- 可读取并修改任务、项目、版块、标签、评论、提醒、筛选器、笔记及共享标签等全部账户数据
- 部分功能（提醒、筛选器、共享标签）需要 Todoist Pro 或 Business 订阅
风险与副作用
- 这是由个人开发者维护的第三方开源项目，并非 Todoist 官方产品
- API 令牌以明文形式存储在客户端配置文件中，需妥善保管避免泄露
- 批量删除、批量完成等操作若配置不当可能对真实 Todoist 数据造成不可逆更改，建议先用 DRYRUN=true 验证
- 任务、评论等内容会经过 Claude 处理，包含敏感信息的用户需自行评估数据流转风险
常见排障
- 出现“未找到 Todoist 项目”或连接错误时，检查 API 令牌是否正确，配置文件中令牌前后是否有多余空格或引号
- MCP 服务器未加载时，确认已全局安装该包（npm list -g @greirson/mcp-todoist），并完全重启 Claude Desktop
- 检查配置文件路径是否与操作系统匹配（macOS/Windows/Claude Code 路径不同），必要时尝试 mcp-todoist 可执行文件的完整路径
- macOS/Linux 上如遇权限错误，可能需要手动创建配置目录（如 mkdir -p ~/.config）并确认 Claude Desktop 有读取权限
使用场景
用自然语言创建、更新、完成 Todoist 任务和子任务
批量创建、更新或删除多个任务以提升效率
通过 Quick Add 语法快速录入包含日期、项目、标签、优先级的任务
管理项目、版块、标签、评论及提醒
在正式执行自动化脚本前，用 Dry-Run 模式验证批量操作是否符合预期
支持客户端
Claude Desktop完整支持
Claude Code完整支持