MCP-Todoist Integration

基本能力

产品定位

mcp-todoist 是一个任务管理集成服务，通过 MCP 协议为语言模型提供与 Todoist 平台交互的能力。

核心功能

• 完整的 Todoist API 集成
• 任务管理：创建、读取、更新、删除任务，标记任务完成/未完成
• 项目管理：创建、读取、更新、删除项目，归档/取消归档项目
• 分区管理：创建、读取、更新、删除项目分区
• 标签管理：创建、读取、更新、删除标签
• 评论管理：创建、读取、更新、删除任务或项目的评论
• 协作功能：获取项目协作者信息
• 任务筛选：支持多种条件筛选任务

适用场景

• 通过语言模型管理个人或团队的任务
• 自动化任务创建和更新流程
• 集成 Todoist 功能到其他应用程序中
• 开发基于 Todoist 的自动化工作流

工具列表

任务管理工具

• create_task - 创建新任务
• get_tasks - 获取筛选后的任务列表
• get_task - 获取特定任务
• update_task - 更新任务
• complete_task - 标记任务为完成
• uncomplete_task - 标记任务为未完成
• delete_task - 删除任务

项目管理工具

• get_projects - 获取所有项目
• get_project - 获取特定项目
• add_project - 创建新项目
• update_project - 更新项目
• delete_project - 删除项目
• archive_project - 归档项目
• unarchive_project - 取消归档项目

分区管理工具

• get_sections - 获取项目所有分区
• get_section - 获取特定分区
• add_section - 创建新分区
• update_section - 更新分区
• delete_section - 删除分区

标签管理工具

• get_labels - 获取所有标签
• get_label - 获取特定标签
• add_label - 创建新标签
• update_label - 更新标签
• delete_label - 删除标签

评论管理工具

• get_comments - 获取任务或项目的评论
• get_comment - 获取特定评论
• add_comment - 添加评论
• update_comment - 更新评论
• delete_comment - 删除评论

协作工具

• get_collaborators - 获取项目协作者

常见问题解答

1. 如何获取 Todoist API Token？
2. 登录 Todoist 账户
3. 进入 Settings > Integrations

4. 从 "API token" 部分复制您的 API token

5. 如何测试 MCP 服务？

6. 使用 mcp run main.py 进行交互式测试
7. 使用 mcp dev main.py 通过 MCP Inspector 进行可视化交互

使用教程

使用依赖

• Python 3.10 或更高版本
• Todoist 账户及 API token
• MCP 兼容客户端（如 Claude Desktop）

安装教程

推荐方式（使用 uvx）

1. 安装包： bash uvx install mcp-todoist

2. 配置 Claude Desktop： json "mcpServers": { "todoist": { "command": "uvx", "args": ["mcp-todoist"], "env": { "TODOIST_API_TOKEN": "your_todoist_api_token_here" } } }

从源代码安装

1. 克隆仓库： bash git clone https://github.com/your-username/mcp-todoist.git cd mcp-todoist

2. 安装依赖： bash pip install -r requirements.txt

3. 创建 .env 文件： bash cp .env.example .env # 编辑 .env 文件添加您的 Todoist API token

调试方式

1. 使用 MCP 开发工具运行： bash mcp run main.py

2. 使用 MCP Inspector 进行可视化调试： bash mcp dev main.py

3. 使用 uv 运行（开发模式）： bash uv run mcp dev main.py

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。