Taskmaster Todoist MCP

🚀 TaskMaster：用于Cursor AI的Todoist MCP

用于Todoist集成的模型上下文协议（MCP）服务器实现，专为Cursor AI开发。该服务器允许Cursor人工智能助手直接从您的编码环境与您的Todoist任务交互。

演示视频

特性

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

- 按截止日期筛选：今天、明天、逾期 - 按优先级筛选（1-4，其中1为最高） - 使用复杂查询组合进行筛选

• 丰富的任务格式：每个任务都用清晰的图标显示优先级、截止日期和其他相关信息
• Cursor AI集成：在Cursor AI编码环境中无缝使用Todoist

安装

通过Smithery安装

通过以下方式自动安装TaskMaster for Claude Desktop 铁匠铺:

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

先决条件

• Python 3.10或更高版本
• 诗歌（用于依赖管理）
• Todoist帐户和API令牌

设置

1. 克隆此存储库：

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

1. 安装依赖项：

pip install -r requirements.txt

1. 将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" -未来四小时内到期的任务和所有逾期任务
• "no date" -没有截止日期的任务
• "5 days" 或 "next 5 days" -未来5天内到期的任务
• "recurring" -具有重复日期的任务

使用Cursor AI进行设置

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

视窗: C:\Users\\.cursor\mcp.json

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

替换 `` 以及包含您实际用户名和正确安装路径的路径。

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

项目结构

代码库被组织成模块：

• api/：Todoist的API包装
• config/：配置和设置
• utils/：实用函数和助手，包括任务格式化

路线图

以下是为未来版本计划的功能：

• 任务创建：直接从Cursor AI向Todoist添加新任务
• 任务完成：在不切换上下文的情况下将任务标记为已完成
• 任务删除：删除不再需要的任务
• 智能任务平衡：基于人工智能的任务再平衡，基于：

- 项目优先级 - 时间承诺 - 到期日 - 当前工作量

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

许可证

MIT许可证