Todoist MCP Server (Python)

基本能力

产品定位

Todoist MCP Server 是一个任务管理工具，旨在通过 MCP 服务与 Todoist 平台集成，提供任务管理和操作的功能。

核心功能

• 与 Todoist API 集成，实现任务管理
• 提供 Python 实现的 MCP 服务，便于开发者使用
• 支持通过 Claude Desktop 进行配置

适用场景

• 个人任务管理
• 团队协作中的任务分配和跟踪
• 自动化任务处理

工具列表

• 通过 main.py 文件中的 mcp.tool() 函数定义的工具，具体工具列表可以通过 grep 命令查看。

常见问题解答

• 需要获取 Todoist API Token 才能使用该服务
• 需要 Python 3.10+ 和 UV 包管理器

使用教程

使用依赖

• Python 3.10+
• UV 包管理器
• Todoist API Token

安装 UV 包管理器的命令：

# 参考 UV 的安装指南
https://docs.astral.sh/uv/installation/

安装教程

1. 获取 Todoist API Token
2. 配置 claude_desktop_config.json 文件，添加以下内容：

{
  "mcpServers": {
    "todoist": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/todoist-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_api_token"
      }
    }
  }
}

调试方式

查看可用工具的命令：

ggrep -Po '(?<=^mcp.tool\(\)\()([^)]+)' main.py

许可证

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