remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Allows Cursor AI assistants to interact with Todoist tasks, providing tools for task retrieval with powerful filtering options by due date, priority, and complex queries.

🚀 TaskMaster：适用于 Cursor AI 的 Todoist MCP

专为 Cursor AI 开发的用于 Todoist 集成的模型上下文协议 (MCP) 服务器实现。此服务器允许 Cursor AI 助手直接从您的编码环境与您的 Todoist 任务进行交互。

演示视频

特征

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

安装

先决条件

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

设置

克隆此存储库：

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

安装依赖项：

pip install -r requirements.txt

将您的 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 配置文件：

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>和路径替换为您的实际用户名和正确的安装路径。

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

项目结构

代码库分为以下模块：

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

路线图

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

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

执照

MIT 许可证

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

模型上下文协议服务器使 Cursor AI 助手能够直接从编码环境与 Todoist 任务进行交互，支持高级任务过滤和丰富的格式。