Todoist MCP助手✅
英语 | 中文
  
将AI代理连接到您的 简洁日程 任务 通过模型上下文协议（MCP）。
创建、搜索、完成和管理您的Todoist任务——所有这些都可以通过Claude、Gemini、Cursor或任何兼容MCP的AI代理完成。
______________________________________________________________________
✨ 特性
| 类别 | 工具 | 描述 |
|---|---|---|
| 📋 任务 | get_tasks, get_task, create_task, update_task, close_task, delete_task, reopen_task | 带优先级、截止日期和标签的完整任务CRUD |
| 🚚 移动 | move_task, move_task_by_name | 在项目、部门和家长之间移动任务 |
| 🔍 智能搜索 | search_task_by_name, complete_task_by_name, delete_task_by_name, update_task_by_name | 按名称查找和操作任务（模糊匹配） |
| 📁 项目 | list_projects, create_project, update_project, delete_project, get_project_overview | 管理项目+完整结构概述 |
| 📑 章节 | list_sections, create_section, update_section, delete_section | 组织和重命名部分 |
| 🏷️ 标签 | list_labels, create_label | 标签管理 |
| 💬 评论 | get_comments, create_comment | 任务和项目评论 |
| ⚙️ 配置 | set_api_token, get_current_config | 运行时令牌管理 |
共27个工具 --最全面的Todoist MCP服务器。
______________________________________________________________________
🚀 快速开始
选项A：快速运行 uvx （推荐）
无需安装--在临时隔离环境中运行：
uvx todoist-mcp-helper没有uv？安装它：curl -LsSf https://astral.sh/uv/install.sh | sh
选项B：安装 pip
pip install todoist-mcp-helper获取您的API代币
- 首选 Todoist设置→ 集成
- 滚动到 开发者 → 复制您的 API代币
______________________________________________________________________
📋 配置
所有凭据都通过传递 环境变量 --代码中没有令牌。
| 变量 | 描述 | 必填 |
|---|---|---|
TODOIST_API_TOKEN | 您的Todoist API代币 | ✅ |
______________________________________________________________________
🔧 平台配置
克劳德桌面版
添加 claude_desktop_config.json:
uvx (recommended)pip
{
"mcpServers": {
"todoist": {
"command": "uvx",
"args": ["todoist-mcp-helper"],
"env": {
"TODOIST_API_TOKEN": "your_token"
}
}
}
}{
"mcpServers": {
"todoist": {
"command": "todoist-mcp-helper",
"env": {
"TODOIST_API_TOKEN": "your_token"
}
}
}
}双子星命令行工具
添加 ~/.gemini/settings.json:
uvx (recommended)pip
{
"mcpServers": {
"todoist": {
"command": "uvx",
"args": ["todoist-mcp-helper"],
"env": {
"TODOIST_API_TOKEN": "your_token"
}
}
}
}{
"mcpServers": {
"todoist": {
"command": "todoist-mcp-helper",
"env": {
"TODOIST_API_TOKEN": "your_token"
}
}
}
}光标
添加 .cursor/mcp.json:
uvx (recommended)pip
{
"mcpServers": {
"todoist": {
"command": "uvx",
"args": ["todoist-mcp-helper"],
"env": {
"TODOIST_API_TOKEN": "your_token"
}
}
}
}{
"mcpServers": {
"todoist": {
"command": "todoist-mcp-helper",
"env": {
"TODOIST_API_TOKEN": "your_token"
}
}
}
}CherryStudio/其他MCP客户端
{
"todoist": {
"command": "uvx",
"args": ["todoist-mcp-helper"],
"env": {
"TODOIST_API_TOKEN": "your_token"
}
}
}ModelScope (魔塔)
选择 工作室 在MCP服务配置中选择模式，然后使用：
{
"mcpServers": {
"todoist": {
"command": "uvx",
"args": ["todoist-mcp-helper"],
"env": {
"TODOIST_API_TOKEN": "your_token"
}
}
}
}添加 TODOIST_API_TOKEN 在环境变量部分中使用API令牌值。
______________________________________________________________________
💡 用法示例
配置后，询问您的AI代理：
- *“显示我今天的任务”*
- *“创建一个任务：购买杂货，明天到期，优先级2”*
- *“完成关于杂货的任务”*
- *“将杂货任务转移到我的购物项目中”*
- *“搜索与会议相关的任务”*
- *“列出我的所有项目”*
- *“向我展示完整的项目概述和部分”*
- *“为我的最新任务添加评论”*
______________________________________________________________________
🔐 运行时配置
在不重新启动的情况下更改令牌：
set_api_token--运行时切换Todoist帐户get_current_config--检查当前配置
______________________________________________________________________
💖 支持
如果这个项目对你有帮助，可以考虑给我买杯咖啡！ 您的支持使这个项目保持活力并不断发展✨
☕ 爱发电 (Afdian)
支持支付宝和微信支付
💎 加密货币（USDC/ERC-20）
点击捐赠--支持MetaMask、SafePal等
每一点点都有帮助-- 非常感谢。 🙏
______________________________________________________________________
📄 许可证
MIT许可证——见 许可证 了解详情。