Todoist MCP Server (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配置

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

{
  "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"
      }
    }
  }
}

使用Goose（和本地LLM）配置

您可以使用Goose和一个本地LLM提供商：LM Studio或Ollama。

配置Goose使用的LLM：

$ goose configure

此命令会询问您是否要使用本地模型还是云托管模型。确保您的模型提供商正在运行您的模型。指定模型API地址和模型名称。许多本地部署的LLM使用与Ollama兼容的格式，因此对于LM Studio或Ollama的LLM，选择Ollama。

◇  我们应该使用哪个模型提供商？
│  Ollama 
│
◇  提供商Ollama需要OLLAMA_HOST，请输入值
│  localhost:1234
│
◇  模型获取完成
│
◇  请输入该提供商的模型：
│  phi-4

然后再次运行相同的命令来配置Todoist MCP：

$ goose configure

这次它会询问扩展程序：

◇  您想配置什么？
│  添加扩展 
│
◇  您想添加哪种类型的扩展？
│  命令行扩展 
│
◇  您想如何称呼此扩展？
│  todoist
│
◇  应该运行什么命令？
│  uvx git+https://github.com/mikemc/todoist-mcp-server
│
◇  请为此工具设置超时时间（秒）：
│  60
│
◇  您想要添加描述吗？
│  不 
│
◇  您想要添加环境变量吗？
│  是 
│
◇  环境变量名称：
│  TODOIST_API_TOKEN
│
◇  环境变量值：
│  ▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪
│
◇  是否要添加另一个环境变量？
│  不 
│
└  已添加todoist扩展

现在您可以运行goose并询问有关您的待办事项列表的问题，或进行更改。

$ goose          
启动会话 | 提供者: ollama 模型: phi-4
    日志到 ******
    工作目录: ******

Goose正在运行！输入您的指令，或尝试询问Goose可以做什么。

( O)> 我在过去7天内完成了多少个待办事项任务

─── todoist_get_tasks | todoist ──────────────────────────
过滤: 最近7天已完成

...
*理想情况下* 这一周您非常忙碌。您已经完成了15项任务！以下是这些任务的列表。
...

可用工具

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

# 如果已通过`brew install grep`在Mac上安装了GNU grep作为ggrep
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文件。