项目简介

Todoist MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在让您可以通过支持 MCP 协议的 LLM 客户端（如 Claude）与 Todoist 进行交互。它允许 LLM 读取和操作您的 Todoist 任务、项目、标签等数据，实现任务管理和自动化。

主要功能点

管理 Todoist 任务：创建、查看、更新、关闭、删除任务。
管理 Todoist 项目：创建、查看、更新、删除项目。
管理 Todoist 标签：创建、查看、更新、删除标签。
管理 Todoist 评论：添加、查看、更新、删除评论。
通过过滤器获取任务：根据各种条件检索任务。

安装步骤

确保您已安装 Node.js 和 npm。
克隆或下载此仓库的代码到本地。
打开终端，进入仓库根目录。
运行 'npm install' 安装依赖。
运行 'npm run build' 构建服务器应用。

服务器配置

本 MCP 服务器需要 Todoist API Key 才能访问您的 Todoist 数据。请先前往 Todoist > 设置 > 集成 > 开发者获取 API Key。
假设您使用的 MCP 客户端是 Claude 桌面应用，您需要编辑 Claude 的配置文件 'claude_desktop_config.json'，添加一个新的 MCP 服务器配置。
在 'claude_desktop_config.json' 文件中，找到 '"mcpServers"' 部分（如果没有则创建），添加以下 JSON 配置：

{
    "mcpServers": {
        "todoist-mcp": {
            "command": "node",
            "args": ["/path/to/repo/build/index.js"],
            "env": {
                "TODOIST_API_KEY": "your_todoist_api_key"
            }
        }
    }
}

配置参数说明:
- '"todoist-mcp"': 服务器名称，您可以自定义，在 Claude 中用于识别此服务器。
- '"command": "node"': 启动服务器的命令，这里使用 Node.js 运行 JavaScript 代码。
- '"args": ["/path/to/repo/build/index.js"]': 启动命令的参数，指向您本地仓库中构建后的 'index.js' 文件路径。请将 '/path/to/repo' 替换为您的仓库实际路径。
- '"env": { "TODOIST_API_KEY": "your_todoist_api_key" }"': 设置环境变量，'TODOIST_API_KEY' 用于存储您的 Todoist API Key。请将 '"your_todoist_api_key"' 替换为您在 Todoist 开发者页面获取的 API Key。

基本使用方法

启动 Claude 桌面应用。
在 Claude 中，您可以指示 Claude 使用 Todoist MCP 服务器来操作您的 Todoist。例如，您可以提问：“帮我添加一个任务到 Todoist 项目 ‘工作’，内容是 ‘准备会议材料’”。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息