Todoist MCP Server

社区

通过自然语言管理 Todoist 任务、项目、评论与标签的 MCP 服务器

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

53FMRS · D

基于 README 的社区维护 MCP 服务器，完整覆盖 Todoist REST API v2 并支持 Sync API，工具覆盖任务、项目、分区、评论、标签，支持批量操作与自然语言交互。文档清晰，支持多种主流 MCP 客户端。适合重度 Todoist 用户，但需注意其非官方身份与 token 安全。

最强项 · 文档质量 14/20 最弱项 · 安全与权限 7/20

可靠性

9/20

安全与权限

7/20

维护活跃度

10/20

文档质量

14/20

安装易用性

13/20

查看各项评分依据

可靠性 9/20: README 描述了完整的工具清单(任务/项目/分区/评论/标签/工具)并给出了 `npm run build && npx @modelcontextprotocol/inspector` 的开发调试方式,说明作者本地测试过 MCP 初始化与工具列表流程,具备一定可信度。但仓库材料中没有提供 CI 工作流或自动化测试文件的证据,也没有展示错误处理、参数校验或依赖失败时的降级策略,均无法在静态审查中核实。按静态校准规则,在缺乏可核验的 CI+测试证据时可靠性不得超过 12 分,故给出 9 分,反映'happy path 可信但边缘情况/错误处理未知'的情况。
安全与权限 7/20: 凭证通过环境变量 API_KEY 传入,未见硬编码密钥或明文token示例,属于合理做法。但 Todoist API token 本身是账号级权限,服务未提供任何范围限制或最小权限说明;同时 delete_tasks、delete_projects、delete_sections、delete_comments、delete_labels、remove_shared_labels 等不可逆删除类工具在文档中没有描述任何二次确认、备份或撤销机制,也未说明网络出站范围或数据流向的额外披露。这些是明显的风险敞口,但未发现恶意代码、隐蔽数据外传或伪造身份等红线证据,因此未落入 0-4 红线区间,而是在'主要风险可见但确认/范围机制不完整'的中低区间给分。
维护活跃度 10/20: 仓库为 MIT 许可,非 Archived 状态,并已发布至 npm(带版本徽章),说明具备基本的发布与许可治理。但提供材料中没有 CHANGELOG、发布历史、最近提交时间或维护者响应速度的证据,64 星/10 个未关闭 issue 只是发现信号,不能直接换算为维护活跃度分数。缺少可核实的持续维护证据导致只能给出中等分数。
文档质量 14/20: README 结构完整,包含获取 API Token 的步骤、面向 Claude Desktop/Claude Code/Cursor/Codex/Gemini CLI 等多平台的配置示例、按类别整理的完整工具列表、示例问法和开发者本地调试命令,可用性较好。缺陷在于:各工具仅有一行功能描述,未列出具体入参/返回结构、错误码、速率限制、费用或额度说明,也没有专门的故障排查(troubleshooting)章节,一些隐藏假设(如 token 权限范围、Sync API 使用差异)未展开说明,故扣分。
安装易用性 13/20: 安装路径清晰:通过 `npx -y todoist-mcp` 一条命令加环境变量即可运行,并为多个主流客户端提供了具体配置片段,复杂度低、步骤少。但由于本审查是纯静态审查,材料中没有实际执行日志、CI 运行记录或集成测试可验证该流程端到端可用,按规则安装易用性上限为 15 分,因此在'步骤清晰但未经证实'的区间给分。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

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

适合谁

已在使用 Todoist 并希望用 AI 助手管理任务的 Claude Desktop / Cursor / Codex / Gemini CLI 用户
需要通过对话或筛选语言批量处理任务的用户

不适合谁

不使用 Todoist 的用户
需要官方 Todoist 支持或保证的用户（本项目为社区维护，MIT 许可）

所需权限

需要 Todoist API token，拥有该账户下任务、项目、分区、评论与标签的完整读写权限

风险与副作用

API token 泄露可能导致任务数据被查看、修改或删除
AI 误解指令可能误删或误改任务、项目
社区第三方项目，非 Todoist 官方维护

安装接入

准备工作

运行环境：Node.js

API_KEY 必填密钥 Todoist API 令牌，在 Todoist 账户的 Settings → Integrations → Developer 下获取。

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

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

.vscode/mcp.json

{
  "servers": {
    "todoist": {
      "command": "npx",
      "args": [
        "-y",
        "todoist-mcp"
      ],
      "env": {
        "API_KEY": "your_todoist_api_token"
      }
    }
  }
}

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

Terminal

claude mcp add todoist -e API_KEY=your_todoist_api_token -- npx -y todoist-mcp

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

生成并校验客户端配置

验证是否装好

在客户端的 MCP 服务器配置中添加 todoist（npx -y todoist-mcp）并设置 API_KEY，重启客户端后，工具列表中应出现 get_tasks_list、create_tasks 等工具；询问"我有哪些项目？"若能返回 Todoist 项目即连接成功。

常见排障

确认 API_KEY 环境变量已设置为有效的 Todoist API token
在 Todoist 设置 → 集成 → Developer 中核对 token
确认已安装 Node.js 且 npx 可用
使用 @modelcontextprotocol/inspector 排查服务器连接问题

试试这样问

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

我今天有哪些任务？
创建一个任务，在下周五前审查季度报告
新建一个名为 Home Renovation 的项目
给我的牙医预约任务标记为已完成

工具能力 36

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 破坏性

删除任务

展开其余 28 个工具

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 筛选语言批量检索任务

支持客户端

Claude Desktop

Claude Code

Cursor

Codex

Gemini CLI

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

详细介绍

这是一个 Model Context Protocol (MCP) 服务器，由社区开发者维护，将 Claude 等 AI 助手与 Todoist 集成。它完整实现了 Todoist REST API v2，并支持 Sync API，允许用户用自然语言创建、更新、关闭、重开、移动和删除任务，管理项目、分区、评论和个人与共享标签。启动时会通过服务器指令自动向 AI 提供项目和标签上下文，并支持批量处理与按名称搜索。