Todoist MCP Server

🚀 Todoist MCP 服务器（Python）

这是一个用 Python 编写的 Todoist MCP 服务器，借助 Todoist Python API 实现相关功能。最初，我利用 Claude 将 TypeScript Todoist MCP 服务器 翻译成 Python 从而创建了该服务器。之后，随着我在使用 Claude 辅助任务管理方面的不断实验，逐渐对其进行修改并添加功能，以适配我的工作流程。

🚀 快速开始

此服务器基于 Python 编写，结合 Todoist Python API 实现功能。你可以按照后续的安装和配置步骤，让它为你的任务管理助力。

✨ 主要特性

• 借助 Python 语言和 Todoist Python API，实现对 Todoist 项目、部分和任务的管理。
• 提供多种工具函数，涵盖项目、部分和任务的增删改查操作。

📦 安装指南

先决条件

• 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 文件。