Todoist Python MCP Server

Todoist MCP 服务器

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

特征

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

先决条件

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

如何获取 Todoist API 令牌

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

与 Claude Desktop 一起使用

通过 UVX 运行（无需克隆）

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

然后将此配置添加到您的 Claude 设置中：

从克隆的存储库运行

如果您希望克隆存储库，请使用以下命令：

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

可用工具

服务器为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 客户端
• 模型上下文协议