🚀 任务管理器：Todoist MCP for 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" - 截止日期在May 5之前的所有任务
• "due after: May 5" - 截止日期在May 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": [
        "server.py"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

请将<username>替换为您的实际用户名，并将path/to/todoist-mcp替换为实际安装路径。

📚 详细文档

项目结构

• api/ - 包含与Todoist API交互的代码
• tasks/ - 包含任务逻辑和处理程序
• server.py - 主服务器文件
• requirements.txt - 项目的依赖项列表
• README.md - 项目说明文档

未来计划

• 添加任务创建功能
• 实现任务完成功能
• 支持任务删除操作
• 增加对任务优先级的完全支持
• 提供更复杂的过滤选项

📄 许可证

该项目使用MIT许可证。