MCP Todoist

基本能力

产品定位

todoist-mcp-server 是一个任务管理工具，通过与 Todoist 账户的集成，提供任务创建、更新、完成和删除等功能，帮助用户高效管理日常任务和项目。

核心功能

• 任务管理：创建、更新、完成和删除任务
• 项目组织：在项目中组织任务，并使用标签进行分类
• 搜索和过滤：基于多种条件搜索和过滤任务
• 无缝集成：与 Claude Desktop 无缝集成

适用场景

• 个人任务管理
• 团队项目协作
• 日常任务跟踪

工具列表

任务管理

• list-tasks - 检索和过滤任务
• create-task - 创建新任务
• update-task - 更新现有任务
• complete-task - 标记任务为已完成
• delete-task - 删除任务

项目管理

• list-projects - 获取所有项目
• create-project - 创建新项目
• update-project - 更新项目
• delete-project - 删除项目

标签管理

• list-labels - 获取所有标签
• create-label - 创建新标签
• update-label - 更新标签
• delete-label - 删除标签

实用工具

• search - 使用复杂过滤条件搜索任务

常见问题解答

• MCP Server not available：确保服务器在单独的终端中运行或通过启动脚本运行。
• Authentication errors：检查 Todoist API 令牌是否正确设置在环境中。
• Command not found errors：确保 Astral UV 已安装并在 PATH 中。
• Timeout errors：如果 MCP 服务器响应缓慢，尝试在 Claude Desktop 设置中增加超时时间。

使用教程

使用依赖

• Python 3.11+
• Astral UV
• Todoist account 和 API token
• Claude Desktop (用于使用 MCP 服务器)

安装教程

# 使用 UV 安装
uvx mcp-todoist

调试方式

检查日志

cat /path/to/mcp-todoist/todoist-mcp.log

启用调试模式

export MCP_DEBUG=true
uvx mcp-todoist

验证 API 令牌

curl -X GET \
  https://api.todoist.com/rest/v2/projects \
  -H "Authorization: Bearer $TODOIST_API_TOKEN"

使用 MCP Inspector

npx @modelcontextprotocol/inspector uvx mcp-todoist

许可证

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