](https://mseep.ai/app/mingolladaniele-taskmaster-todoist-mcp)
🚀 TaskMaster：用于Cursor AI的Todoist MCP
](https://smithery.ai/server/@mingolladaniele/taskMaster-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令牌
设置
- 克隆此存储库：
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.pyMCP工具
服务器提供以下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许可证
