任务大师：Todoist MCP 对于 Cursor AI

一个专为 Cursor AI 开发的 Todoist 模型上下文协议（MCP）服务器实现。此服务器允许 Cursor AI 助手直接从您的编程环境中与您的 Todoist 任务交互。

演示视频

功能

• 灵活的任务过滤：使用 Todoist 强大的筛选语法进行任务过滤
  • 按截止日期筛选：今天、明天、逾期
  • 按优先级水平（1-4，其中 1 是最高）筛选
  • 使用复杂查询组合进行筛选
• 丰富的任务格式化：每个任务显示优先级、截止日期和其他相关信息，并带有清晰的图标
• 与 Cursor AI 的集成：在您的 Cursor AI 编程环境中无缝使用 Todoist

安装

先决条件

• 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" - 2024 年 1 月 3 日截止的任务
• "due before: May 5" - 在 2024 年 5 月 5 日之前截止的任务
• "due after: May 5" - 在 2024 年 5 月 5 日之后截止的任务
• "due before: +4 hours" - 在接下来的四小时内截止以及所有逾期任务
• "no date" - 没有截止日期的任务
• "5 days" 或 "next 5 days" - 接下来的五天内截止的任务
• "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。现在您应该可以使用 Todoist 任务了！

项目结构

• api/ - API 包裹器
• config/ - 配置与设置
• models/ - 模型相关文件
• tasks/ - 任务处理逻辑
• utils/ - 工具和辅助函数

许可证

此项目使用 MIT 许可证。