Todoist Integration MCP Server 使用说明

项目简介

Todoist Integration MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器应用，旨在将您的 Todoist 账户连接到支持 MCP 协议的 LLM 客户端（如 Claude）。通过此服务器，您可以让 LLM 理解您的 Todoist 数据，并执行诸如创建、查看、更新和删除任务、项目、标签等操作，从而实现通过自然语言控制和管理您的 Todoist 待办事项。

主要功能点

任务管理: 支持创建、查看、更新、关闭、删除、重新打开任务，移动任务到项目或 section，以及移动任务到父任务。
项目管理: 支持创建、查看、更新、删除项目，获取项目协作成员。
Section管理: 支持在项目中创建、查看、更新、删除 section。
评论管理: 支持在任务和项目中添加、查看、更新、删除评论。
标签管理: 支持添加、查看、更新、删除标签，包括共享标签的管理。
完整的 Todoist API 支持: 几乎支持 Todoist TypeScript Client 提供的所有 API 功能。

安装步骤

安装 Node.js 和 npm: 确保您的电脑上已安装 Node.js 和 npm (Node 包管理器)。
下载仓库代码: 从 GitHub 仓库 https://github.com/miottid/todoist-mcp 下载代码到本地。
安装依赖: 打开终端，进入仓库代码根目录，运行以下命令安装项目依赖：
```
npm install
```
构建项目: 运行以下命令构建项目：
```
npm run build
```

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude 桌面应用）连接，您需要配置客户端的 MCP 服务器设置。以下是针对 'claude_desktop_config.json' 的配置示例，您需要根据您的实际情况进行修改：

{
  "mcpServers": {
    "todoist-mcp": {  // 服务器名称，可以自定义，用于在客户端中标识
      "command": "node", // 启动服务器的命令，这里使用 node.js 运行
      "args": ["/path/to/repo/build/index.js"], // 服务器启动参数，指向编译后的 index.js 文件路径。请将 "/path/to/repo" 替换为您的仓库代码在本地的实际路径
      "env": {
        "TODOIST_API_KEY": "your_todoist_api_key" // 环境变量，用于配置 Todoist API 密钥。请将 "your_todoist_api_key" 替换为您的 Todoist API 密钥
      }
    }
  }
}

获取 Todoist API Key: 您需要前往 Todoist > Settings > Integrations > Developer 获取您的 Todoist API 密钥，并将其填入上述配置的 'TODOIST_API_KEY' 环境变量中。

配置 MCP 客户端: 根据您使用的 MCP 客户端（如 Claude 桌面应用）的文档，找到 MCP 服务器配置的位置，并将上述 JSON 配置添加到客户端的配置文件中。通常，客户端会读取 'claude_desktop_config.json' 文件（对于 Claude 桌面应用）。

基本使用方法

启动 MCP 客户端: 启动您配置了 Todoist Integration MCP Server 的 MCP 客户端（如 Claude 桌面应用）。
与 LLM 交互: 使用自然语言指示 LLM 执行 Todoist 相关操作。例如，您可以对 Claude 说：
- "创建一个名为 '购买牛奶' 的任务"
- "将 '购买牛奶' 任务添加到 '购物清单' 项目"
- "列出我今天的所有任务"
- "更新任务 '购买牛奶' 的截止日期为明天"

LLM 将会通过 MCP 协议调用 Todoist Integration MCP Server 提供的工具，与您的 Todoist 账户进行交互，并返回结果。

注意: 请确保您的 MCP 客户端已正确配置并连接到 Todoist Integration MCP Server，并且您已在服务器配置中设置了正确的 Todoist API 密钥。

关键词