Todoist MCP Server

🚀 Todoist MCP 服務器（Python）

這是一個用 Python 編寫的 Todoist MCP 服務器，藉助 Todoist Python API 實現功能。最初，我通過 Claude 將 TypeScript Todoist MCP 服務器 翻譯成 Python 來創建此服務器。在使用 Claude 輔助任務管理的實驗過程中，我不斷對其進行修改和功能添加，以適配我的工作流程。

🚀 快速開始

本服務器使用 Python 編寫，藉助 Todoist Python API 實現功能，能很好地輔助任務管理。以下是使用前的安裝和配置步驟。

📦 安裝指南

先決條件

• Python 3.10+
• UV 包管理器（安裝指南）
• Todoist API 令牌

獲取 Todoist API 令牌

1. 登錄到您的 Todoist 賬戶。
2. 進入設置 → 集成。
3. 在“開發者”部分下找到您的 API 令牌。

使用 Claude Desktop 配置

將以下內容添加到您的 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"
      }
    }
  }
}

💻 使用示例

查看可用工具

運行以下命令查看當前可用工具：

# 假設您已安裝 GNU grep（例如在 Mac 上通過 `brew install grep`）
ggrep -Po '(?<=^mcp.tool\(\)\()([^)]+)' main.py

截至 2025-04-25，可用工具包括：

• 項目
  • 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_create_task
  • todoist_get_tasks
  • todoist_get_task
  • todoist_update_task
  • todoist_move_task
  • todoist_close_task
  • todoist_reopen_task
  • todoist_delete_task

📄 許可證

該項目使用 MIT License。有關詳細信息，請參閱 LICENSE 文件。