MCP Todoist

基本能力

产品定位

该服务是一个任务管理工具，通过 MCP 协议与 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 token 是否正确设置
• Command not found：确保 Astral UV 已安装并在 PATH 中
• Timeout errors：尝试增加 Claude Desktop 设置中的超时时间

使用教程

使用依赖

• Python 3.11+
• Astral UV
• Todoist 账户和 API token
• Claude Desktop

安装 Astral UV：

# 安装 Astral UV
curl -sSL https://docs.astral.sh/uv/installation/ | bash

安装教程

1. 安装服务：

uvx mcp-todoist

1. 配置环境变量：

export TODOIST_API_TOKEN=your_api_token_here

1. 配置 Claude Desktop：

{
  "mcpServers": {
    "mcp-todoist": {
      "command": "uvx",
      "args": ["mcp-todoist"]
    }
  }
}

调试方式

1. 检查日志：

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

1. 启用调试模式：

export MCP_DEBUG=true
uvx mcp-todoist

1. 验证 API token：

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

1. 使用 MCP Inspector：

npx @modelcontextprotocol/inspector uvx mcp-todoist

许可证

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