AI导哈

Todoist任务管理协议

一个为Cursor AI开发的Todoist集成服务，允许在编码环境中直接与Todoist任务交互。

  • by mingolladaniele
  • Python
  • 本地部署
  • 42 星标
  • 更新于
在 GitHub 查看 mingolladaniele/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\<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> 以及包含您实际用户名和正确安装路径的路径。

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

项目结构

代码库被组织成模块：

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

路线图

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

  • 任务创建：直接从Cursor AI向Todoist添加新任务
  • 任务完成：在不切换上下文的情况下将任务标记为已完成
  • 任务删除：删除不再需要的任务
  • 智能任务平衡：基于人工智能的任务再平衡，基于：
    • 项目优先级
    • 时间承诺
    • 到期日
    • 当前工作量
  • 项目管理：创建和管理Todoist项目
  • 标签和过滤器：添加自定义标签并创建已保存的过滤器

许可证

MIT许可证

相关 MCP