AI导哈

Todoist任务管理服务

连接Claude Desktop、Cowork和Claude Code到Todoist账户的服务，提供任务、项目、部分、评论和标签的完整CRUD功能。

  • by AlobarQuest
  • Python
  • 混合部署
  • 更新于
在 GitHub 查看 AlobarQuest/todoist-mcp

使用说明

⚠️ 已归档：该项目已退役，不再维护。 原因：被Claude连接器注册表中的官方Todoist MCP插件替换。 退休日期：2026年3月22日

Todoist MCP服务器

MCP服务器，将Claude Desktop、Cowork和Claude Code连接到您的Todoist帐户。任务、项目、部分、注释和标签的完整CRUD。

工具（共25个）

任务

  • todoist_list_tasks --列出/筛选任务（按项目、部分、标签或Todoist筛选语法）
  • todoist_get_task --按ID获取单个任务
  • todoist_create_task --创建截止日期、优先级、标签、定期计划
  • todoist_update_task --更新任何任务字段
  • todoist_close_task --标记完成（推进重复任务）
  • todoist_reopen_task --重新打开已完成的任务
  • todoist_delete_task --永久删除

项目

  • todoist_list_projects / todoist_get_project / todoist_create_project / todoist_update_project / todoist_delete_project

章节

  • todoist_list_sections / todoist_create_section / todoist_update_section / todoist_delete_section

评论

  • todoist_list_comments / todoist_create_comment / todoist_update_comment / todoist_delete_comment

标签

  • todoist_list_labels / todoist_create_label / todoist_update_label / todoist_delete_label

先决条件

  1. Todoist API代币 --来自：Todoist→ 设置→ 集成→ 开发者
  2. Python 3.12+ （供当地使用）或 码头工人 （用于VPS部署）

快速入门--本地（stdio）

# Clone and install
git clone https://github.com/alobarquest/todoist-mcp.git
cd todoist-mcp
pip install -r requirements.txt

# Set your token
export TODOIST_API_TOKEN="your_token_here"

# Run (stdio mode for local clients)
python -m src.server

本地开发

运行测试

pip install -r requirements.txt
python -m pytest tests/ -v

棉绒

ruff check src/ tests/

Claude桌面配置

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "todoist": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "/path/to/todoist-mcp",
      "env": {
        "TODOIST_API_TOKEN": "your_token_here"
      }
    }
  }
}

Claude代码配置

添加到您的项目 .mcp.json 或全球 ~/.claude/settings.json:

{
  "mcpServers": {
    "todoist": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "/path/to/todoist-mcp",
      "env": {
        "TODOIST_API_TOKEN": "your_token_here"
      }
    }
  }
}

远程服务器（通过Coolify的VPS）

当部署到VPS时，服务器以流式HTTP模式运行。

将Claude Desktop连接到远程服务器：

{
  "mcpServers": {
    "todoist": {
      "url": "https://todoist-mcp.devonwatkins.com/mcp/"
    }
  }
}

Coolify的环境变量：

变量 描述
TODOIST_API_TOKEN 您的Todoist API代币（来自BWS）
MCP_TRANSPORT streamable_http （在Dockerfile中设置）
MCP_PORT 8000 （在Dockerfile中设置）

部署--Coolify/Hetzner虚拟专用服务器

这如下 口味A 来自德文郡的Infra标准（轻质、单容器）。

然而，由于我们使用GHCR图像拉取（而不是源代码构建），CI/CD遵循风味B模式：

  1. 推至 main → GitHub Actions构建镜像→ 推动 ghcr.io/alobarquest/todoist-mcp
  2. Coolify webhook触发重新部署→ 提取最新图像

冷却设置

  • 构建类型： Docker镜像
  • 图片： ghcr.io/alobarquest/todoist-mcp:latest
  • 端口： 8000
  • 域名： todoist-mcp.devonwatkins.com
  • 健康检查： http://127.0.0.1:8000/health/ready
  • 环境： TODOIST_API_TOKEN 来自BWS

GitHub回购秘密

  • COOLIFY_WEBHOOK_URL --冷却此资源的部署webhook
  • COOLIFY_API_TOKEN -Coolify API承载令牌

健康检查

有两个端点可用于健康监测：

  • /health/live --活体检查。始终返回200 OK。用于验证服务器是否正在运行。
  • /health/ready --准备情况检查。如果满足以下条件，则返回200 OK TODOIST_API_TOKEN 否则，503服务不可用。在Coolify健康检查配置中使用。

CI/CD

所有承诺 main 在部署之前由GitHub Actions验证：

  • 棉绒： ruff check src/ tests/ --代码格式和样式
  • 测验： python -m pytest tests/ -v --所有测试都必须通过

构建和推送作业仅在验证作业通过后运行。PR在合并之前也会经过验证。

速率限制

Todoist允许 每15分钟每用户1000个请求。如果达到此限制，服务器将返回一条明确的错误消息。

许可证

麻省理工学院

相关 MCP