AI导哈

任务安全重排服务

一个为Todoist提供的Python MCP服务器，用于安全地重新安排任务，保留提醒和重复模式。

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

使用说明

todoist mcp

Todoist的Python MCP服务器，提供安全的任务重新调度。

官方Todoist MCP服务器的任务更新工具会自动删除提醒 并在更改截止日期时简化重复任务。此服务器修复了 通过自定义路由所有日期更改 reschedule_task 工具 保留两者。

工具

阅读

工具 说明
get_task 按ID获取单个任务
find_tasks 按Todoist查询字符串、项目或标签筛选任务
find_tasks_by_date 在日期或日期之间到期的任务
get_projects 列出所有项目
get_sections 列出项目中的部分
get_comments 获取任务的评论
get_overview 逾期+今天总结，或项目中的所有任务

写

工具 说明
add_task 创建任务（支持due_string、优先级、标签）
update_task 更新内容、描述、优先级或标签-- 没有截止日期参数
complete_task 标记任务已完成
add_project 创建项目
add_section 创建一个分区
add_comment 向任务添加注释

改期

工具 说明
reschedule_task 将任务移动到新日期，安全地保留重复模式和提醒

update_task 故意在其模式中没有截止日期参数。模型 即使有指示，也无法使用它来更改日期-- reschedule_task 是 唯一的路。

设置

先决条件

  • 紫外线
  • Todoist API令牌（在Todoist找到→ 设置→ 集成→ API令牌）

安装

git clone https://github.com/kpanko/todoist-mcp
cd todoist-mcp
cp .env.example .env
# edit .env and add your token
uv sync

配置Claude代码

添加到MCP配置(.claude/mcp_config.json 或克劳德桌面 claude_desktop_config.json):

{
  "mcpServers": {
    "todoist": {
      "command": "uv",
      "args": [
        "--project", "/path/to/todoist-mcp",
        "run", "todoist-mcp"
      ]
    }
  }
}

服务器读取 TODOIST_API_TOKEN 从环境或从 .env 项目根目录中的文件。无需OAuth或浏览器身份验证——适用于 无头后台服务。

依赖项

为什么不使用官方服务器？

官方服务器位于 https://ai.todoist.net/mcp 需要OAuth（浏览器 流），使其不适合后台服务。它还揭示了一个 update_task 接受到期日期参数的工具，Todoist REST API通过删除提醒并将定期任务转换为一次性任务来处理 任务。

相关 MCP