Todoist MCP Server

这是一个模型上下文协议（MCP）服务器，允许像Claude这样的客户端与Todoist进行交互，通过自然语言实现任务管理功能。该服务器作为客户端和Todoist API之间的中介，处理身份验证、数据转换和命令处理。这是Python版本。

功能

• 任务创建：使用所需内容和可选属性创建新任务
• 任务检索：通过ID获取任务或列出具有过滤选项的任务
• 任务管理：更新任务属性，标记任务为完成，删除任务

预备条件

• Python 3.12
• uv
• 一个Todoist账户和API令牌

如何获取Todoist API令牌

1. 登录到您的Todoist账户
2. 前往用户设置 -> 集成 -> 开发者
3. 复制API令牌

使用Claude桌面版

通过UVX运行（无需克隆）

您可以直接从GitHub使用UVX运行服务器：

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

然后在您的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"
      }
    }
  }
}

从克隆的仓库运行

如果您更喜欢克隆仓库，请使用以下命令：

git clone git@github.com:Johnxjp/todoist-mcp-python.git

然后在您的Claude配置文件中添加：

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

可用工具

该服务器提供以下工具供Claude使用：

1. create_task：在Todoist中创建新任务

   • 必需：content（任务标题）
   • 可选：
     • description，
     • due_date，
     • priority，
     • project_id，
     • section_id，
     • labels

2. get_tasks：根据各种过滤器从Todoist获取任务列表和ID

   • 可选：
     • project_id，
     • project_name，
     • task_name，
     • priority，
     • labels，
     • is_overdue，
     • limit

3. update_task：通过名称搜索更新现有任务

   • 必需：task_id
   • 可选：
     • content，
     • description，
     • labels，
     • priority，
     • due_date（YYYY-MM-DD），
     • deadline_date（YYYY-MM-DD）

4. delete_task：通过名称搜索删除任务

   • 必需：task_id

5. complete_task：通过名称搜索标记任务为完成

   • 必需：task_id

示例交互

这里有一些示例说明Claude如何通过此MCP服务器与Todoist进行交互：

• "添加购买杂货的任务"
• "显示我所有紧急任务"
• "今天有哪些任务到期？"
• "标记洗衣任务已完成"
• "将我的牙医预约优先级改为紧急"

安全注意事项

• 服务器通过环境变量安全地处理您的Todoist API令牌
• 永远不要分享您的.env文件或暴露您的API令牌
• 服务器本地运行，并仅与Todoist API通信

许可证

MIT许可证

致谢

• Todoist API Python客户端
• 模型上下文协议