Todoist MCP Server

社区

通过自然语言让 Claude 管理你的 Todoist 任务和项目

分类: 团队协作第 8 / 55
Stars: ★ 246 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 7 个月前 ⚠
工具数: 19

61FMRS · C

该项目是社区维护的 Todoist MCP 服务器，提供 19 个工具覆盖任务、项目、协作等全流程操作，并具备批量处理和 Dry-Run 演练模式等实用特性；仓库维护者对贡献流程和代码质量要求较为严格（例如要求单一关注点的 PR、真实 API 验证），文档详尽，但用户需自行承担 API 令牌管理和批量操作带来的数据变更风险。

最强项 · 文档质量 16/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

10/20

维护活跃度

13/20

文档质量

16/20

安装易用性

13/20

查看各项评分依据

可靠性 9/20: README 描述了19个MCP工具及其参数分组、Dry-Run模式(可控地模拟变更并保留错误检测)，这在设计上有利于可诊断性。但未提供服务器manifest、未展示实际源码(如src/index.ts的握手逻辑)、也未看到CI工作流或测试文件的实际内容，只是README中提到`npm test`等命令。按静态评审口径，没有可验证的执行证据（真实CI+已提交测试覆盖关键路径），可靠性上限为12分；由于完全无法核实工具声明与真实行为是否一致，扣分至9分。
安全与权限 10/20: 凭证通过环境变量`TODOIST_API_TOKEN`传入，示例中使用占位符而非真实密钥，未见凭证泄露或秘密硬编码问题。Dry-Run模式是积极的安全设计，允许在不产生副作用的情况下验证操作。但Dry-Run默认关闭，`todoist_task_bulk`(bulk_delete)、`todoist_task`(delete)等具有不可逆删除效果的操作在默认模式下未见任何额外确认机制说明；文档也未披露数据出站范围（例如是否有遥测/日志上传）。鉴于任务/项目删除是个人数据、影响面有限，未达到红线(0-4)的严重程度，但权限最小化与危险操作二次确认的证据不足，故评为10分。
维护活跃度 13/20: 项目基于MIT许可证，244星、19个开放issue，未归档，且提供了CHANGELOG.md和详细的贡献指南（要求测试、CI通过、单一关注点PR等），显示出有主动维护和治理意识的迹象。但未见具体的发布节奏、最近提交记录或安全响应渠道（如SECURITY.md）的证据，无法从提供材料中确认依赖更新频率，因此不能视为完全成熟的维护体系，评为13分。
文档质量 16/20: README内容详实，涵盖安装（一键安装+手动JSON配置+两大平台路径）、认证（Token获取链接）、Dry-Run模式详解、19个工具的功能总览表、大量自然语言使用示例、故障排查章节，以及分层的开发者文档指引（TOOLS_REFERENCE.md、架构说明、模块划分）。但对速率限制、成本（API调用配额）以及安全边界的披露较少，工具的详细入参约束需要跳转到外部文件核实，未在评审材料中直接验证，故未给满分，评为16分。
安装易用性 13/20: 安装路径清晰：Claude Desktop一键安装.mcpb、`claude mcp add`命令行、或手动JSON配置，并列出了主流平台的配置文件路径，入门门槛较低。但按静态评审规则，没有可验证的CI/测试执行证据支撑其可运行性上限为15分；且缺乏manifest佐证工具真实可注册，存在未验证的不确定性，故评为13分。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

已在使用 Todoist 且希望通过 Claude 对话管理任务和项目的个人或团队用户
需要执行批量任务操作（如批量更新优先级、批量清理逾期任务）的用户
希望先用 Dry-Run 模式验证自动化脚本，再对真实数据执行操作的开发者

不适合谁

不使用 Todoist、或需要连接其他任务管理工具（如 Jira、Asana）的用户
需要官方 Todoist 出品或提供 SLA 支持保障的企业场景
不希望将 API 令牌和任务数据经由第三方 MCP 服务器处理的高度隐私敏感场景

所需权限

需要提供 Todoist 个人 API 令牌（在 Todoist 开发者设置中获取），该令牌授予账户级别的读写权限
可读取并修改任务、项目、版块、标签、评论、提醒、筛选器、笔记及共享标签等全部账户数据
部分功能（提醒、筛选器、共享标签）需要 Todoist Pro 或 Business 订阅

风险与副作用

这是由个人开发者维护的第三方开源项目，并非 Todoist 官方产品
API 令牌以明文形式存储在客户端配置文件中，需妥善保管避免泄露
批量删除、批量完成等操作若配置不当可能对真实 Todoist 数据造成不可逆更改，建议先用 DRYRUN=true 验证
任务、评论等内容会经过 Claude 处理，包含敏感信息的用户需自行评估数据流转风险

安装接入

准备工作

运行环境：Node.js

TODOIST_API_TOKEN 必填密钥 Todoist 开发者 API 令牌，在 Todoist 设置的 Integrations/Developer 页面获取，必需。

其他可选配置项（1 个）

DRYRUN 可选设为 true 可启用演练模式：变更操作只模拟不执行，可选。

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"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "todoist": {
      "command": "npx",
      "args": [
        "@greirson/mcp-todoist"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add todoist -e TODOIST_API_TOKEN=your_api_token_here -- npx @greirson/mcp-todoist

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

配置后在客户端询问「显示我所有的 Todoist 项目」；如果返回真实项目列表，说明 TODOIST_API_TOKEN 有效、服务器连接正常。也可以运行 todoist_utility 的 test_connection 测试连接。

常见排障

出现“未找到 Todoist 项目”或连接错误时，检查 API 令牌是否正确，配置文件中令牌前后是否有多余空格或引号
MCP 服务器未加载时，确认已全局安装该包（npm list -g @greirson/mcp-todoist），并完全重启 Claude Desktop
检查配置文件路径是否与操作系统匹配（macOS/Windows/Claude Code 路径不同），必要时尝试 mcp-todoist 可执行文件的完整路径
macOS/Linux 上如遇权限错误，可能需要手动创建配置目录（如 mkdir -p ~/.config）并确认 Claude Desktop 有读取权限

试试这样问

连接成功后，可以直接对 AI 助手这样说：

显示我所有的 Todoist 项目
创建任务 'Team Meeting' 到项目 12345，明天截止，标签 ['Urgent']
快速添加：Review PR next Monday #Work @code-review p2 //检查错误处理
把项目 12345 中所有包含 'review' 的任务标记为完成

工具能力 19

todoist_task 写入

创建、查询、更新、删除、完成、重新打开任务，支持优先级、截止日期、标签及 Quick Add 自然语言解析

todoist_task_bulk 破坏性

批量创建、更新、删除、完成多个任务，提升多任务处理效率

todoist_subtask 写入

创建子任务、批量创建、转换为子任务、提升为主任务，并查看任务层级结构

todoist_project 破坏性

项目的创建、查询、更新、删除、归档及协作者管理

todoist_project_ops 写入

项目排序、移动到父项目、获取已归档项目等高级项目操作

todoist_section 破坏性

版块的创建、查询、更新、删除、移动、排序和归档

todoist_label 破坏性

标签的创建、查询、更新、删除及使用统计

todoist_comment 破坏性

任务/项目评论的创建、查询、更新、删除

展开其余 11 个工具

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 功能）的创建、查询、重命名、移除

使用场景

用自然语言创建、更新、完成 Todoist 任务和子任务

批量创建、更新或删除多个任务以提升效率

通过 Quick Add 语法快速录入包含日期、项目、标签、优先级的任务

管理项目、版块、标签、评论及提醒

在正式执行自动化脚本前，用 Dry-Run 模式验证批量操作是否符合预期

支持客户端

Claude Desktop

Claude Code

依据项目文档列出，未经本站实测。

详细介绍

一个开源的 MCP 服务器，将 Claude 与 Todoist 连接起来，通过自然语言实现完整的任务和项目管理。提供 19 个工具，覆盖任务、子任务、项目、版块、标签、评论、提醒、筛选器、协作、用户资料、活动日志、已完成任务、备份、笔记和工作区共享标签等功能，并支持批量操作和 Quick Add 自然语言解析。内置 Dry-Run（演练）模式，可在不实际修改 Todoist 数据的情况下验证操作。