Todoist MCP 服务器使用说明

项目简介

Todoist MCP 服务器是一个基于 Model Context Protocol (MCP) 的后端服务，它充当 LLM 客户端（如 Claude）与 Todoist 任务管理工具之间的桥梁。通过此服务器，用户可以使用自然语言指令，让 LLM 客户端操作和管理 Todoist 中的任务，例如创建新任务、查看任务列表、更新任务信息、标记完成任务以及删除任务等。

主要功能点

自然语言任务管理：使用日常语言创建、更新、完成和删除 Todoist 任务。
智能任务搜索：通过部分名称匹配查找任务。
灵活的任务过滤：按截止日期、优先级和其他属性筛选任务。
丰富的任务详情：支持任务描述、截止日期和优先级。
直观的错误处理：提供清晰的错误反馈，改善用户体验。

安装步骤

确保已安装 Node.js 和 npm。
打开终端或命令提示符。

运行以下命令全局安装 Todoist MCP 服务器：

npm install -g @abhiz123/todoist-mcp-server

服务器配置

要将此 MCP 服务器与 MCP 客户端（如 Claude Desktop）配合使用，您需要在客户端的配置文件中添加服务器配置信息。以 'claude_desktop_config.json' 为例，配置信息如下：

{
  "mcpServers": {
    "todoist": {  // 服务器名称，可以自定义
      "command": "npx",  // 启动服务器的命令
      "args": ["-y", "@abhiz123/todoist-mcp-server"], // 启动服务器的参数
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here" // 您的 Todoist API Token，请替换为实际 Token
      }
    }
  }
}

配置步骤：

获取 Todoist API Token：
- 登录您的 Todoist 账户。
- 导航到 "设置" -> "集成"。
- 在 "开发者" 部分找到您的 API Token 并复制。
配置 MCP 客户端：
- 打开您的 MCP 客户端配置文件（例如 'claude_desktop_config.json'）。
- 将上述 JSON 配置代码添加到 'mcpServers' 字段中。
- 将 '"your_api_token_here"' 替换为您在 Todoist 网站上获取的 API Token。
- 确保您的 MCP 客户端已正确加载此配置文件。

基本使用方法

配置完成后，您的 MCP 客户端即可通过以下方式与 Todoist MCP 服务器交互：

创建任务：例如，您可以向 LLM 客户端输入指令：'Create task '项目会议'' 或 'Add task '审查代码' due tomorrow at 3pm'。
获取任务：例如，您可以输入：'Show all my tasks' 或 'List tasks due today' 或 'Get high priority tasks'。
更新任务：例如，您可以输入：'Update documentation task to be due next week' 或 'Change priority of bug fix task to urgent'。
完成任务：例如，您可以输入：'Mark the PR review task as complete' 或 'Complete the documentation task'。
删除任务：例如，您可以输入：'Delete the PR review task' 或 'Remove meeting prep task'。

具体指令取决于 LLM 客户端的解析能力，上述示例指令旨在提供参考。您可以使用自然语言与 LLM 客户端交流，指示其调用 Todoist MCP 服务器提供的工具来管理您的 Todoist 任务。

关键词