Todoist MCP 服务器

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

特征

• 任务创建：创建具有必需内容和可选属性的新任务

• 任务检索：通过 ID 获取任务或使用过滤选项列出任务

• 任务管理：更新任务属性、标记任务完成、删除任务

Related MCP server: Notion MCP

先决条件

• Python 3.12

• 紫外线

• Todoist 帐户和 API 令牌

如何获取 Todoist API 令牌

1. 登录您的 Todoist 账户

2. 前往用户设置 -> 集成 -> 开发者

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

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

   • 必填：内容（任务标题）

   • 选修的：

     • 描述，

     • 到期日，

     • 优先事项，

     • 项目ID，

     • 部分 ID，

     • 标签

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

   • 选修的：

     • 项目ID，

     • 项目名称，

     • 任务名称，

     • 优先事项，

     • 标签，

     • 已过期，

     • 限制

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

   • 必填：task_id

   • 选修的：

     • 内容，

     • 描述，

     • 标签，

     • 优先事项，

     • 到期日（YYYY-MM-DD），

     • 截止日期（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 客户端

• 模型上下文协议