Todoist MCP 服务器

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

特征

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

Related MCP server: Notion MCP

先决条件

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