todoist-mcp

功能特性

• 完整的 Todoist API 集成：访问完整的 Todoist REST API v2，并通过自然语言支持 Todoist Sync API

• 批量处理：客户端可以在单个请求中处理多个任务

• 按名称搜索：AI 可以按名称而非 ID 搜索任务、项目和标签

• 任务：使用对话语言创建、更新、完成、重新打开、移动和删除任务

• 项目：创建和管理项目及分区

• 评论：添加和管理任务及项目的评论

• 标签：创建和管理个人及共享标签

• 智能上下文：启动时，通过服务器指令自动向 AI 提供您的项目和标签信息 — 无需额外的工具调用

• 提示词支持：您可以轻松地向客户端提供有关您项目的信息

Related MCP server: Notion API MCP Server

配置

您需要一个 Todoist API 令牌才能使用此 MCP 服务器。

获取 Todoist API 令牌

1. 登录您的 Todoist 账户

2. 导航至“设置” → “集成”

3. 在“开发者”下方找到您的 API 令牌

使用方法

在您的平台配置中的 mcpServers 添加：

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

Codex — CLI：

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。