MCP-Todoist 集成

本项目提供一个 模型上下文协议 (MCP) 服务器，该服务器与 Todoist 集成，允许语言模型与 Todoist 任务和项目进行交互。

功能特性

• 创建、读取、更新和完成 Todoist 任务
• 访问 Todoist 项目、版块和标签
• 按各种条件筛选任务
• 具有完善文档的工具和资源，可供语言模型使用

环境要求

• Python 3.10 或更高版本
• 具有 API 令牌的 Todoist 帐户
• 兼容 MCP 的客户端（如 Claude Desktop）

安装

1. 克隆此存储库：

   git clone https://github.com/your-username/mcp-todoist.git
   cd mcp-todoist
   

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 创建一个包含您的 Todoist API 令牌的 .env 文件：

   cp .env.example .env
   # 编辑 .env 文件以添加您的 Todoist API 令牌
   

获取 Todoist API 令牌

1. 登录到您的 Todoist 帐户
2. 转到设置 > 集成
3. 从“API 令牌”部分复制您的 API 令牌

使用方法

使用 MCP 开发工具运行

对于测试和开发，请使用 MCP 开发工具：

mcp dev main.py

这将启动 MCP Inspector，允许您以交互方式测试服务器。

在 Claude Desktop 中安装

要在 Claude Desktop 中安装服务器：

mcp install main.py

可用工具

以下 Todoist 工具可用：

• create_task - 创建新任务
• get_tasks - 根据过滤器获取任务
• get_task - 按 ID 获取特定任务
• update_task - 更新现有任务
• complete_task - 将任务标记为完成
• delete_task - 删除任务
• get_projects - 获取所有项目

可用资源

以下 Todoist 资源可用：

• todoist://tasks - 所有任务
• todoist://tasks/project/{project_id} - 特定项目中的任务
• todoist://tasks/section/{section_id} - 特定版块中的任务
• todoist://tasks/label/{label} - 具有特定标签的任务
• todoist://projects - 所有项目
• todoist://sections/{project_id} - 特定项目中的版块
• todoist://labels - 所有标签

示例

创建任务

Please create a new task in Todoist called "Buy groceries" due tomorrow.

请在 Todoist 中创建一个名为“购买杂货”的新任务，截止日期为明天。

从项目中获取任务

Show me all tasks in my "Work" project.

显示我的“工作”项目中的所有任务。

完成任务

Mark the "Buy groceries" task as complete.

将“购买杂货”任务标记为完成。

开发

要为项目做出贡献或根据您的需要进行修改：

1. Fork 存储库
2. 进行更改
3. 使用 mcp dev main.py 进行测试
4. 提交 pull request

许可证

MIT