Todoist MCP 服务器 (Python)

一个用 Python 编写的 Todoist MCP 服务器，使用了Todoist Python API 。我最初使用 Claude 将这个TypeScript Todoist MCP 服务器转换为 Python 版本来创建这个服务器。随着我尝试使用 Claude 来帮助管理任务，我正在逐步修改和添加功能以适应我的工作流程。

安装

先决条件

• Python 3.10+

• UV 包管理器（安装指南）

• Todoist API令牌

获取 Todoist API 令牌

1. 登录您的 Todoist 帐户

2. 前往“设置”→“集成”

3. 在“开发者”下找到您的 API 令牌

使用 Claude Desktop 进行配置

将 MCP 服务器添加到您的 claude_desktop_config.json 中，

{
  "mcpServers": {
    "todoist": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mikemc/todoist-mcp-server",
        "todoist-mcp"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_api_token"
      }
    }
  }
}

或者，从本地副本运行，

{
  "mcpServers": {
    "todoist": {
      "command": "uvx",
      "args": [
        "--from",
        "/absolute/path/to/todoist-mcp-server",
        "todoist-mcp"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_api_token"
      }
    }
  }
}

Related MCP server: Todoist MCP Server

可用工具

要查看当前可用的工具，请运行

# With GNU grep installed as ggrep (as with `brew install grep` on Mac)
ggrep -Po '(?<=^mcp.tool\(\)\()([^)]+)' src/main.py

截至 2025 年 5 月 26 日，

• 项目

  • todoist_get_projects

  • todoist_get_project

  • todoist_add_project

  • todoist_update_project

  • todoist_delete_project

• 章节

  • todoist_get_sections

  • todoist_get_section

  • todoist_add_section

  • todoist_update_section

  • todoist_delete_section

• 任务

  • todoist_get_task

  • todoist_get_tasks

  • todoist_filter_tasks

  • todoist_add_task

  • todoist_update_task

  • todoist_complete_task

  • todoist_uncomplete_task

  • todoist_move_task

  • todoist_delete_task

• 评论

  • todoist_get_comment

  • todoist_get_comments

  • todoist_add_comment

  • todoist_update_comment

  • todoist_delete_comment

执照

本项目遵循 MIT 许可证。详情请参阅LICENSE文件。