← 返回目录

Todoist MCP Server

官方

将 Todoist 任务管理功能接入 AI 助手的官方 MCP 服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 团队协作第 47 / 55
Stars: ★ 554 非常热门
传输方式: Streamable HTTP · stdio（本地进程）
运行环境: Node.js · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 6 天前
工具数: 5

40FMRS · D

Todoist MCP 服务器是官方维护的，提供可靠的任务管理集成。设计注重可复用性和完整工作流，而非零散的原子操作。支持多种主流客户端，安装配置简单。适合个人和开发者，但需注意权限和数据安全。

最强项 · 安装易用性 12/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

6/20

维护活跃度

7/20

文档质量

10/20

安装易用性

12/20

查看各项评分依据

可靠性 5/20: 仅提供了 README 和仓库元数据，没有提供源代码、CI 日志或测试文件，无法验证服务器能否干净启动、完成 MCP 握手或工具清单是否与实际行为一致。README 声称支持 npm start、npx @doist/todoist-mcp 和多种客户端，但按证据规则这些是不可信声明，因此可靠性只能给 5 分：没有发现明显矛盾，但关键路径完全无独立证据。
安全与权限 6/20: README 展示的凭据处理方式是 TODOIST_API_KEY 环境变量和浏览器 OAuth，没有出现真实令牌、恶意代码或隐蔽外传等红线问题。但缺少源码级审查，无法确认最小权限、数据边界、写操作（如 addTasks）的确认机制；README 只提示写操作前先检查账号、建议使用测试账号，未说明工具内置确认或撤销机制。因此给 6 分。
维护活跃度 7/20: 仓库未归档、有 MIT 许可证，README 描述了 release-please 和 publish 工作流，这是维护迹象。但没有提供提交历史、版本发布记录、issue 响应时效或依赖更新证据；9 个 open issues 本身不能证明维护活跃度，按缺证扣分原则给 7 分。
文档质量 10/20: README 覆盖了安装、OAuth/API key 认证、Claude Desktop、Cursor、Claude Code、VS Code 等多个客户端的配置示例，并指向 docs/ 下的分层文档。但工具完整参数、速率限制、成本、常见故障排查没有在 README 中提供，所引用的 docs 文件内容也未提供给本次审查，因此给 10 分。
安装易用性 12/20: README 给出了从 npx 到远程 HTTP 地址 https://ai.todoist.net/mcp，以及四个主流客户端的具体 JSON/命令配置，步骤看起来少且明确。但由于没有源码、CI 或测试证据证明这些配置可复现，静态校准上限为 15；实际给 12 分，扣分原因是安装后的握手和平台兼容性未被文件证据验证。

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

查看 FMRS 评分方法 →

选型与风险

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

适合谁

需要 AI 助手直接操作 Todoist 任务的用户。
希望在 Claude、Cursor、VS Code 等 AI 工具中无缝管理任务的开发者。
希望通过可复用工具构建自定义 AI 工作流的开发者。

不适合谁

不需要 AI 任务管理功能的用户。
需要多用户协作或权限管理功能的企业用户（该服务器仅操作单个用户账户）。
对数据隐私有严格要求的用户（可能需要评估第三方服务）。

所需权限

需要有效的 Todoist API 密钥（TODOIST_API_KEY）或通过 OAuth 认证。
工具可以读取和修改用户的 Todoist 账户数据，包括任务、项目和标签。

风险与副作用

AI 代理可能意外删除或修改任务，建议使用测试账户或临时项目。
API 密钥或 OAuth 令牌泄露可能导致账户被未授权访问。
由于依赖外部服务，可能存在服务中断或延迟。

安装接入

准备工作

运行环境：Node.js · 远程托管（无需本地环境）

TODOIST_API_KEY 必填密钥 Todoist API 密钥，在 Todoist 开发者设置/账户集成页面生成；直接运行工具（npm run tool）或作为库使用时必需，MCP 远程服务则使用 OAuth。

使用 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"
      ]
    }
  }
}

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

.vscode/mcp.json

{
  "servers": {
    "todoist": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ai.todoist.net/mcp"
      ]
    }
  }
}

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

Terminal

claude mcp add todoist -- npx -y mcp-remote https://ai.todoist.net/mcp

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

生成并校验客户端配置

验证是否装好

在客户端工具列表中确认 todoist 服务器的工具（如 findTasksByDate、addTasks、search、fetch）已出现；首次调用任意 Todoist 工具时会通过浏览器完成 OAuth 认证，认证成功即说明连接正常。

常见排障

确保 TODOIST_API_KEY 设置正确，可使用 `npm run tool -- user-info '{}'` 验证连接账户。
检查网络连接和防火墙，确保能访问 `https://ai.todoist.net/mcp`。
对于写操作，先使用测试环境以避免意外数据修改。

试试这样问

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

按日期查找我的任务
帮我在今天添加一个任务：买牛奶
搜索包含“报告”的任务
获取这个任务的详细信息

工具能力 5

search 只读

遵循 OpenAI MCP 规范，执行搜索操作，返回 JSON 编码结果。

fetch 只读

遵循 OpenAI MCP 规范，获取指定内容，返回 JSON 编码结果。

findTasksByDate 只读

根据日期查找任务。

addTasks 写入

添加新任务。

other_tools_in_src_tools

更多工具位于 src/tools 目录，可查看完整列表。

使用场景

让 AI 助手帮助用户管理 Todoist 中的任务，如查找、创建、修改任务。

通过自然语言与 AI 对话来操作 Todoist 账户。

在自定义 AI 应用中集成 Todoist 工具，实现任务自动化。

支持客户端

Claude Desktop

Cursor

Claude Code

VS Code

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

详细介绍

Todoist 官方提供的 MCP 服务器，允许 AI 代理代表用户访问和修改其 Todoist 账户。提供一组可复用的工具，支持通过 MCP 或直接集成到自定义 AI 对话界面。