项目简介

Todoist MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在桥接 Todoist 任务管理系统和大型语言模型 (LLM) 应用，例如 Claude。通过提供一系列预定义的工具，该服务器允许 LLM 应用以自然语言的方式与用户的 Todoist 账户进行交互，实现任务的创建、查询、更新、完成和删除等操作。

主要功能点

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

安装步骤

手动安装 (推荐): 打开终端，运行以下命令全局安装 Todoist MCP Server：

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

服务器配置

要将 Todoist MCP Server 与 MCP 客户端（例如 Claude Desktop）配合使用，您需要在客户端的配置文件中添加服务器配置信息。以 'claude_desktop_config.json' 为例，您需要添加 'mcpServers' 配置项，并在其中定义 'todoist' 服务器。

{
  "mcpServers": {
    "todoist": {
      "command": "npx",  // 启动服务器的命令，这里使用 npx 执行 node_modules 中的可执行文件
      "args": ["-y", "@abhiz123/todoist-mcp-server"], // 传递给命令的参数，-y 表示自动确认安装，@abhiz123/todoist-mcp-server 是要执行的包名
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here" // 环境变量，用于传递 Todoist API Token，请替换为您的真实 API Token
      }
    }
  }
}

注意：

获取 Todoist API Token: 您需要在 Todoist 官网登录您的账户，进入 "设置" -> "集成"，在 "开发者" 部分找到并复制您的 API Token，并将其替换到上述 'your_api_token_here' 的位置。
'command' 和 'args': 'command' 指定了启动服务器的命令，通常为 'npx' 或 'node'。'args' 数组包含了传递给命令的参数，根据实际安装方式和包名进行调整。 '-y' 参数用于在使用 'npx' 安装包时自动确认，避免交互式提示。 '@abhiz123/todoist-mcp-server' 是安装的 npm 包名，也是服务器的入口。

基本使用方法

配置完成后，MCP 客户端将能够通过以下预定义的工具与 Todoist MCP Server 交互。您可以使用自然语言指令调用这些工具，例如：

创建任务:

"Create task '购买牛奶'"
"添加任务 '预约牙医' 明天下午 3 点到期"
"创建高优先级任务 '修复 Bug'，描述为 '关键性能问题'"

获取任务:

"显示所有任务"
"列出今天到期的任务"
"获取高优先级任务"
"显示本周到期的任务"

更新任务:

"将文档任务的截止日期更改为下周"
"将 Bug 修复任务的优先级更改为紧急"
"为团队会议任务添加描述"

完成任务:

"标记 PR 评审任务为已完成"
"完成文档任务"

删除任务:

"删除 PR 评审任务"
"移除会议准备任务"

请注意： 具体的指令格式和自然语言理解能力取决于您使用的 LLM 客户端和模型。上述示例仅供参考。

关键词

信息