AI导哈

任务管理助手

Todoist MCP Helper 是一个连接AI代理与Todoist任务的服务，支持创建、搜索、完成和管理任务，适用于各种MCP兼容的AI代理。

  • by LittlePeter52012
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 LittlePeter52012/todoist-mcp-helper

使用说明

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代币

  1. 首选 Todoist设置→ 集成
  2. 滚动到 开发者 → 复制您的 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许可证——见 许可证 了解详情。

相关 MCP