TaskMaster Todoist Mcp

开发官方认证 Python

🚀 任务管理器：Todoist MCP for Cursor AI

这是一个专为Cursor AI开发的Todoist模型上下文协议（MCP）服务器实现。借助该服务器，Cursor AI助手能够直接在您的编码环境里与您的Todoist任务进行交互。

🚀 快速开始

安装

先决条件

Python 3.10或更高版本
Poetry（用于依赖管理）
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

与Cursor AI一起使用

要与Cursor AI一起使用，请创建或编辑MCP配置文件： Windows：C:\Users\\.cursor\mcp.json

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

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

✨ 主要特性

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

💻 使用示例

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" - 具有重复截止日期的任务

📚 详细文档

演示视频

项目结构

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

未来计划

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

📄 许可证

该项目使用MIT许可证。

0 条评论
分类：开发