Todoist MCP Server

功能

• 完整的 Todoist API 集成：通过自然语言访问完整的 Todoist REST API v2，并支持 Todoist Sync API
• 批量处理：客户端可在单个请求中处理多个任务
• 按名称搜索：AI 可按名称搜索任务、项目和标签，无需使用 ID
• 任务：使用对话式语言创建、更新、关闭、重新打开、移动和删除任务
• 项目：创建和管理项目与分区
• 评论：添加和管理任务与项目的评论
• 标签：创建和管理个人标签与共享标签
• 智能上下文：启动时自动通过服务指令向 AI 提供你的项目和标签，无需额外调用工具
• 提示词支持：你可以轻松向客户端提供项目相关信息

配置

使用此 MCP 服务需要 Todoist API 令牌。

获取 Todoist API 令牌

1. 登录 Todoist 账号
2. 前往“设置” →“集成”
3. 在“开发者”下找到 API 令牌

使用方法

将其添加到平台配置中的 mcpServers：

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

平台	配置
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json（macOS）、%APPDATA%\Claude\（Windows）
Claude Code	.mcp.json — claude mcp add --transport stdio --scope project --env API_KEY=token todoist -- npx -y todoist-mcp
Cursor	~/.cursor/mcp.json 或 .cursor/mcp.json
Codex	~/.codex/config.toml 或 .codex/config.toml — 参见下方示例
Gemini CLI	~/.gemini/settings.json — gemini mcp add -e API_KEY=token todoist npx -y todoist-mcp

Codex — 命令行：

codex mcp add todoist --env API_KEY=your_token -- npx -y todoist-mcp

或者添加到 config.toml：

[mcp_servers.todoist]
command = "npx"
args = ["-y", "todoist-mcp"]

[mcp_servers.todoist.env]
API_KEY = "your_todoist_api_token"

可用工具

任务

• get_tasks_list：获取任务，可按项目、分区、标签或 ID 进行筛选
• get_tasks_by_filter：使用 Todoist 筛选语言获取任务（例如 "today"、"overdue"、"P1 | P2"、"#Work & @urgent"）
• 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 格式获取包含分区和参数的项目列表

使用示例

向你的 AI 助手（例如 Claude）提问，例如：

"What tasks do I have due today?"
"Create a task to review the quarterly report by next Friday"
"Make a new project called 'Home Renovation'"
"Add a comment to my meeting prep task"
"Show me all my high priority tasks"
"Create a label for 'Urgent' tasks with a red color"
"What projects do I have in my Todoist?"
"Mark my dentist appointment task as complete"

开发

# Install dependencies
npm install

# Build the project and run inspector
npm run build && npx @modelcontextprotocol/inspector -e API_KEY=YOUR_API_KEY_HERE node dist/index.js

许可证

本项目基于 MIT 许可证授权，详情请参阅 LICENSE 文件。

问题与支持

如果遇到问题或需要支持，请在 GitHub 代码仓库中提交 issue。