Todoist MCP 服务器

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

特征

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

先决条件

Python 3.12
紫外线
Todoist 帐户和 API 令牌

如何获取 Todoist API 令牌

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

与 Claude Desktop 一起使用

通过 UVX 运行（无需克隆）

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

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提供了以下工具供使用：

create_task ：在 Todoist 中创建新任务
- 必填：内容（任务标题）
- 选修的：
  - 描述，
  - 到期日，
  - 优先事项，
  - 项目ID，
  - 部分 ID，
  - 标签
get_tasks ：使用各种过滤器从 Todoist 获取任务和 ID 列表
- 选修的：
  - 项目ID，
  - 项目名称，
  - 任务名称，
  - 优先事项，
  - 标签，
  - 已过期，
  - 限制
update_task ：通过名称搜索来更新现有任务
- 必填：task_id
- 选修的：
  - 内容，
  - 描述，
  - 标签，
  - 优先事项，
  - 到期日（YYYY-MM-DD），
  - 截止日期（YYYY-MM-DD）
delete_task ：通过名称搜索来删除任务
- 必填：task_id
complete_task ：通过名称搜索将任务标记为完成
- 必填：task_id

交互示例

以下是 Claude 如何通过此 MCP 服务器与 Todoist 交互的一些示例：

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

Todoist Python MCP Server

Integrations