使用说明

项目简介

Todoist MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在将 Todoist 任务管理工具与 AI 助手（如 Claude）连接起来。通过这个服务器，用户可以使用自然语言指令，让 AI 助手直接操作和管理 Todoist 中的任务、项目、标签等。

主要功能点

完整的 Todoist API 集成: 支持 Todoist REST API v2 和 Sync API，覆盖任务、项目、标签、评论和 Section 等核心功能。
自然语言任务管理: 允许用户通过 AI 助手的自然语言对话，完成任务的创建、更新、关闭、删除、移动等操作。
项目和标签管理: 支持项目和标签的创建、更新、删除和查询，方便用户组织和分类任务。
评论支持: 允许在任务和项目上添加、查看、更新和删除评论，方便协作和信息记录。
灵活的工具调用: 提供了一系列预定义的工具，例如 'get_tasks_list'（获取任务列表）、'create_tasks'（创建任务）、'get_projects_list'（获取项目列表）等，AI 助手可以根据用户意图调用这些工具。
通过名称搜索: 支持通过名称而非 ID 查找任务、项目和标签，更符合自然语言交互习惯。

安装步骤

安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node 包管理器)。
全局安装 'todoist-mcp' 包: 打开终端，运行以下命令全局安装 'todoist-mcp' 包。
```
npm install -g todoist-mcp
```
或者，你也可以选择不全局安装，直接在项目中使用 'npx' 运行，具体命令见服务器配置部分。

服务器配置

MCP 服务器需要配置 Todoist API Token 才能访问你的 Todoist 账户。你需要在 MCP 客户端（如 Claude Desktop）的配置文件中添加服务器配置信息。

以 'claude_desktop_config.json' 为例，你需要配置 'mcpServers' 字段，添加一个名为 'todoist' 的服务器配置。配置信息如下：

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": [
        "-y",
        "todoist-mcp"
      ],
      "env": {
        "API_KEY": "YOUR_TODOIST_API_TOKEN" // 将 "YOUR_TODOIST_API_TOKEN" 替换为你的 Todoist API Token
      }
    }
  }
}

配置参数说明:

'server name': 'todoist' (服务器名称，可以自定义，用于在客户端中引用)
'command': 'npx' (Node.js 包执行器，用于运行本地或全局安装的 npm 包)
'args':
- '"-y"': 'npx' 的参数，表示自动同意执行包。
- '"todoist-mcp"': 要执行的 npm 包名称，这里指向全局安装的 'todoist-mcp' 包。如果你没有全局安装，而是希望在项目本地运行，可能需要调整 'command' 和 'args'，例如指向本地 node_modules 目录下的执行文件 (例如: '"command": "node", "args": ["node_modules/todoist-mcp/dist/index.js"]')。但对于 Claude Desktop 这样的客户端，通常全局安装并使用 'npx' 是更方便的方式。
'env': 环境变量配置。
- 'API_KEY': 'YOUR_TODOIST_API_TOKEN' (你的 Todoist API Token，请务必替换为你在 Todoist 开发者设置中获取的 API Token。获取方法参考 README.md 中的 "Getting a Todoist API Token" 部分)

基本使用方法

配置完成后，启动你的 MCP 客户端（如 Claude Desktop），客户端会自动连接到 Todoist MCP Server。

你可以通过自然语言指令与 AI 助手对话，例如：

"What tasks do I have due today?" (我今天有哪些任务到期？)
"Create a task to review the quarterly report by next Friday" (创建一个任务，下周五前审核季度报告)
"Make a new project called 'Home Renovation'" (创建一个名为“房屋装修”的新项目)
"Add a comment to my meeting prep task" (给我的会议准备任务添加一条评论)
"Show me all my high priority tasks" (显示所有高优先级任务)
"Mark my dentist appointment task as complete" (将我的牙医预约任务标记为完成)

AI 助手会解析你的自然语言指令，并调用 Todoist MCP Server 提供的工具来执行相应的 Todoist 操作。

关键词