Todoist MCP Server

基本能力

产品定位

Todoist MCP Server 是一个任务管理和日程安排工具，通过自然语言与 AI 助手交互，提升任务管理效率。

核心功能

• Todoist API 集成：支持完整的 Todoist REST API v2 和 Sync API，通过自然语言操作。
• 批量处理：支持在单个请求中处理多个任务。
• 任务管理：创建、更新、关闭、重新打开、移动和删除任务。
• 项目管理：创建和管理项目及部分。
• 评论管理：添加和管理任务和项目的评论。
• 标签管理：创建和管理个人及共享标签。
• 提示支持：提供项目信息的便捷访问。

适用场景

• 通过自然语言快速管理任务和项目。
• 批量处理任务，提高效率。
• 与 AI 助手（如 Claude）集成，实现智能任务管理。

工具列表

• Tasks：get_tasks_list, create_tasks, get_tasks, update_tasks, close_tasks, reopen_tasks, delete_tasks, move_tasks。
• Projects：get_projects_list, create_projects, get_projects, update_projects, delete_projects, get_collaborators, move_projects。
• Sections：get_sections_list, create_sections, get_sections, update_sections, delete_sections。
• Comments：get_comments_list, create_comments, get_comments, update_comments, delete_comments。
• Labels：get_labels_list, create_labels, get_labels, update_labels, delete_labels, get_shared_labels, rename_shared_labels, remove_shared_labels。
• Utils：utils_get_colors。

常见问题解答

• 如何获取 Todoist API Token？
• 登录 Todoist 账户，进入 Settings → Integrations，在 "Developer" 下找到 API Token。
• 如何与 Claude Desktop 集成？
• 在 claude_desktop_config.json 中添加配置。

使用教程

使用依赖

• 需要安装 Node.js 和 npm。

安装教程

# 安装依赖
npm install

# 构建项目并运行检查器
npm run build && npx @modelcontextprotocol/inspector -e API_KEY=YOUR_API_KEY_HERE node dist/index.js

调试方式

• 使用 npm run build 构建项目后，通过检查器运行服务。

示例用法

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

许可证

该项目遵循 MIT 开源许可条款。