Todoist Python MCP Server

基本能力

产品定位

Todoist Python MCP Server 是一个任务管理工具，通过自然语言处理技术，使用户能够通过 MCP 客户端（如 Claude）与 Todoist 进行交互，实现任务的创建、查询、更新和删除等功能。

核心功能

• 任务创建：支持创建新任务，包括必填的内容和可选的属性（如描述、截止日期、优先级等）。
• 任务检索：支持通过 ID 获取任务或根据过滤条件列出任务。
• 任务管理：支持更新任务属性、标记任务为完成、删除任务等操作。

适用场景

• 个人任务管理：通过自然语言快速添加、查询或更新任务。
• 团队协作：通过 MCP 客户端与团队成员共享任务状态。
• 自动化工作流：与其他工具集成，实现任务管理的自动化。

工具列表

1. create_task：创建新任务。
2. 必填：任务标题（content）。
3. 可选：描述、截止日期、优先级、项目 ID、部分 ID、标签等。
4. get_tasks：获取任务列表。
5. 可选过滤条件：项目 ID、项目名称、任务名称、优先级、标签、是否逾期、限制数量等。
6. update_task：更新任务。
7. 必填：任务 ID。
8. 可选：内容、描述、标签、优先级、截止日期等。
9. delete_task：删除任务。
10. 必填：任务 ID。
11. complete_task：标记任务为完成。
12. 必填：任务 ID。

常见问题解答

• 如何获取 Todoist API Token：登录 Todoist 账户，进入用户设置 -> 集成 -> 开发者，复制 API Token。
• 安全性：API Token 通过环境变量安全处理，切勿共享 .env 文件或暴露 API Token。

使用教程

使用依赖

• Python 3.12
• uv
• Todoist 账户和 API Token

安装教程

通过 UVX 运行（无需克隆仓库）

uvx --from https://github.com/Johnxjp/todoist-mcp-python.git mcp-server-todoist

通过克隆仓库运行

git clone [email protected]:Johnxjp/todoist-mcp-python.git

调试方式

在 Claude 配置文件中添加以下配置：

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

或

{
  "mcpServers": {
    "todoist-server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "todoist_api_python",
        "mcp",
        "run",
        "/full/path/to/todoist_server.py"
      ],
      "env": {
        "TODOIST_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

许可证

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