🚀 TaskMaster: Todoist MCP for Cursor AI

🚀 TaskMaster：适用于 Cursor AI 的 Todoist MCP

这是一个用于集成 Todoist 的模型上下文协议（MCP）服务，专为 Cursor AI 开发。此服务允许 Cursor AI 助手直接在你的编码环境中与 Todoist 任务交互。

演示视频

功能

• 灵活的任务筛选：使用 Todoist 强大的筛选语法筛选任务
  • 按截止日期筛选：今天、明天、已逾期
  • 按优先级筛选（1–4，其中 1 级最高）
  • 使用复杂的查询组合进行筛选
• 丰富的任务格式：每项任务都会清晰显示优先级、截止日期及其他相关信息，并配有图标
• Cursor AI 集成：在 Cursor AI 编码环境中无缝使用 Todoist

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 TaskMaster：

npx -y @smithery/cli install @mingolladaniele/taskMaster-todoist-mcp --client claude

前置条件

• Python 3.10 或更高版本
• Poetry（用于依赖项管理）
• Todoist 账户和 API 令牌

设置

1. 克隆此代码仓库：

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

2. 安装依赖项：

pip install -r requirements.txt

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

# Linux/macOS
export TODOIST_API_TOKEN="your-api-token-here"

# Windows
set TODOIST_API_TOKEN="your-api-token-here"

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

用法

运行服务

python server.py

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" - 接下来 4 小时内到期的任务以及所有已逾期的任务
• "no date" - 没有截止日期的任务
• "5 days" 或 "next 5 days" - 接下来 5 天内到期的任务
• "recurring" - 设有重复日期的任务

与 Cursor AI 一起设置

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

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

{
  "mcpServers": {
    "todoist-mcp": {
      "command": "C:/Users/<username>/path/to/todoist-mcp/.venv/Scripts/python.exe",
      "args": [
        "C:/Users/<username>/path/to/todoist-mcp/server.py"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

请将 <username> 和路径替换为你的实际用户名以及安装目录的正确路径。

完成后，前往 Cursor 设置 → MCP，确认服务正在正常运行（绿色圆点）。

项目结构

代码库按模块组织：

• api/：Todoist 的 API 封装
• config/：配置和设置
• utils/：实用函数和辅助工具，包括任务格式化功能

路线图

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

• 创建任务：直接从 Cursor AI 向 Todoist 添加新任务
• 完成任务：无需切换上下文即可将任务标记为已完成
• 删除任务：移除不再需要的任务
• 智能任务平衡：根据以下因素，通过 AI 重新平衡任务：
  • 项目优先级
  • 时间安排
  • 截止日期
  • 当前工作量
• 项目管理：创建和管理 Todoist 项目
• 标签和筛选器：添加自定义标签并创建已保存的筛选器

许可证

MIT 许可证