🚀 TaskMaster：适用于 Cursor AI 的 Todoist MCP

专为 Cursor AI 开发的用于 Todoist 集成的模型上下文协议 (MCP) 服务器实现。此服务器允许 Cursor AI 助手直接从您的编码环境与您的 Todoist 任务进行交互。

演示视频

特征

• 灵活的任务过滤：使用 Todoist 强大的过滤语法过滤任务

  • 按到期日筛选：今天、明天、逾期

  • 按优先级过滤（1-4，其中 1 为最高）

  • 使用复杂查询组合进行过滤

• 丰富的任务格式：每个任务都以清晰的图标显示优先级、截止日期和其他相关信息

• Cursor AI 集成：在您的 Cursor AI 编码环境中无缝使用 Todoist

安装

先决条件

• Python 3.10 或更高版本

• 诗歌（用于依赖管理）

• Todoist 帐户和 API 令牌

设置

1. 克隆此存储库：

2. 安装依赖项：

3. 将您的 Todoist API 令牌设置为环境变量：

您可以在 Todoist 设置 → 集成 → 开发者中找到您的 Todoist API 令牌。

用法

运行服务器

MCP 工具

服务器提供以下MCP工具：

get_tasks_tool

使用强大的过滤选项检索任务。

参数：

• filter_string ：用于复杂过滤的高级 Todoist 过滤器查询字符串

• priority ：可选优先级（1-4，其中 1 为最高优先级）

过滤字符串示例：

• "today" ——今天截止的任务

• "overdue" - 逾期任务

• "Jan 3" ——1 月 3 日截止的任务

• "due before: May 5" - 5 月 5 日之前截止的任务

• "due after: May 5" - 5 月 5 日之后截止的任务

• "due before: +4 hours" - 未来四小时内截止的任务以及所有逾期任务

• "no date" - 没有截止日期的任务

• "5 days"或"next 5 days" - 接下来 5 天内到期的任务

• "recurring" - 具有重复日期的任务

使用 Cursor AI 进行设置

要与 Cursor AI 一起使用，请创建或编辑 MCP 配置文件：

Windows ： C:\Users\<username>\.cursor\mcp.json

将<username>和路径替换为您的实际用户名和正确的安装路径。

完成后，转到光标设置 → MCP 并检查服务器是否正常运行（绿点）。

项目结构

代码库分为以下模块：

• api/ ：Todoist 的 API 包装器

• config/ ：配置和设置

• utils/ ：实用程序函数和帮助程序，包括任务格式化

路线图

以下是计划在未来版本中推出的功能：

• 任务创建：直接从 Cursor AI 向 Todoist 添加新任务

• 任务完成：无需切换上下文即可将任务标记为完成

• 任务删除：删除不再需要的任务

• 智能任务平衡：基于以下原则的人工智能任务再平衡：

  • 项目优先级

  • 时间承诺

  • 截止日期

  • 当前工作量

• 项目管理：创建和管理 Todoist 项目

• 标签和过滤器：添加自定义标签并创建已保存的过滤器

执照

MIT 许可证