项目简介

Todoist MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在让大型语言模型（LLM）客户端能够无缝地与Todoist账户进行交互。它将复杂的Todoist API封装成LLM可理解和调用的工具，实现通过自然语言管理您的任务和项目。

主要功能点

• 全面API集成: 支持Todoist的32个核心操作，包括创建、读取、更新、删除（CRUD）项目、任务、分节、评论和标签。
• 自然语言快速添加: 允许您使用简单的自然语言指令（如“明天早上9点交房租 #财务 p1”）快速创建Todoist任务。
• 智能限速处理: 内置智能机制，自动跟踪Todoist API的每15分钟450次请求限制，并使用指数退避策略重试，确保请求的稳定性和可靠性。
• 易于部署和使用: 无需复杂的服务器设置和认证流程，只需一条命令即可启动，并支持Docker部署。
• 会话管理与能力声明: 作为标准的MCP服务器，它负责维护与LLM客户端的通信会话，并向客户端声明其提供的所有工具能力。

安装步骤

1. 获取Todoist API令牌: 访问 Todoist 官方集成页面 'https://todoist.com/prefs/integrations'，获取您的Todoist个人API密钥。
2. 安装Node.js: 确保您的系统已安装Node.js 18或更新版本。
3. 启动服务器: 在您的终端中运行以下命令。请将 'your-todoist-api-key-here' 替换为您在步骤1中获取的实际API令牌。

   TODOIST_API_KEY=your-todoist-api-key-here npx -y @upspawn/todoist-mcp
   

   如果您偏好使用Docker，也可以通过以下步骤运行：

   docker run -e TODOIST_API_KEY=your-todoist-api-key-here upspawn/todoist-mcp
   

服务器配置

该MCP服务器通过环境变量接收配置信息。在MCP客户端（如VS Code、Cursor等）中配置此服务器时，您需要提供以下信息：

• 服务器名称 (name): 用于在客户端中标识此MCP服务器的名称，例如 'todoist'。
• 启动命令 (command): 'npx'
• 命令参数 (args): '-y', '@upspawn/todoist-mcp' (这些参数告诉 'npx' 直接运行指定的 npm 包)
• 环境变量 (env):
  • 'TODOIST_API_KEY': 您的40字符Todoist个人API令牌。这是连接Todoist API的必需认证凭证。
  • 'TODOIST_API_BASE_URL': (可选) Todoist API的基础URL，默认为 'https://api.todoist.com/api/v1'。通常情况下无需修改此项。
  • 'DEBUG': (可选) 设置为 'true' 可开启服务器的详细日志输出，方便调试。默认为 'false'。
  • 'TODOIST_TIMEOUT': (可选) API请求的超时时间（毫秒）。默认为 '15000' 毫秒（15秒）。
  • 'TODOIST_RETRY_ATTEMPTS': (可选) API请求失败后的重试次数。默认为 '3' 次。

基本使用方法

一旦MCP服务器在您的MCP客户端中配置并成功启动，您可以直接向AI发出指令，利用服务器提供的工具来管理您的Todoist任务和项目，例如：

• "添加 '审查PR #42' 到明天上午10点的 #工作任务"
• "显示我在 #个人 项目中本周到期的所有任务"
• "快速添加 '每周五下午4点发布版本说明 #杂项 p2'"
• "获取我上个月的生产力统计"