Todoist MCP服务器扩展版

这是一个MCP（模型上下文协议）服务器实现，它将Claude（或者如果你足够精通的话，任何兼容MCP的大语言模型）与Todoist集成在一起，通过MCP工具实现自然语言任务管理。该服务器中的工具允许Claude使用日常语言与你的Todoist任务、项目、板块和标签进行交互，同时针对大语言模型的工作流程效率进行了优化。

功能概述

• 任务管理：使用日常语言创建、更新、完成和删除任务
• 标签管理：创建、更新和管理个人标签及任务标签
• 项目管理：创建、更新和管理Todoist项目
• 板块组织：在项目中创建和管理板块
• 智能搜索：使用部分名称匹配查找任务和标签
• 灵活筛选：按项目、板块、截止日期、优先级和标签筛选任务
• 丰富的任务详情：支持描述、截止日期、优先级级别以及项目/板块分配
• 批量操作：工具内置批量操作支持，并提供自定义参数以便与大语言模型工作流程高效配合

有关可用工具及其用法的完整列表，请参阅tools.md。

快速安装指南

假设你已经安装了npm。

更全面的安装指南可以在操作指南中找到。

通过Smithery安装

要通过Smithery为Claude Desktop安装Todoist MCP服务器扩展版：

1. 在cmd\pwsh中运行以下命令：

    npx -y @smithery/cli install @Chrusic/todoist-mcp-server-extended --client claude

也可以兼容cline或windsurf，只需将最后一个参数更改为--client cline或--client windsurf

通过npm安装

1. 在cmd\pwsh中运行以下命令：

    npm install -g @chrusic/todoist-mcp-server-extended

设置

获取Todoist API令牌

1. 登录你的Todoist账户
2. 导航到设置 → 集成
3. 在开发者下找到你的API令牌
4. 点击复制API令牌

有关Todoist API的更多信息，请访问官方Todoist API文档。

将MCP服务器和API令牌添加到Claude Desktop客户端

1. 在你的claude_desktop_config.json文件中，在"mcpServers":{ }:之间粘贴以下JSON片段：

   "todoist": {
     "command": "npx",
     "args": ["-y", "@chrusic/todoist-mcp-server-extended"],
     "env": {
         "TODOIST_API_TOKEN": "在此粘贴你的API令牌"
     }
   }
   

2. 完整的内容应该类似于这样：

   {
   "mcpServers": {
       "todoist": {
       "command": "npx",
       "args": ["-y", "@chrusic/todoist-mcp-server-extended"],
       "env": {
           "TODOIST_API_TOKEN": "在此粘贴你的API令牌"
       }
       }
   }
   }
   

3. Claude Desktop客户端将在下次（重新）启动时启动MCP服务器并加载工具。

使用示例

一些简单的建议，可以询问Claude的内容。请注意，有时你需要非常直接才能让Claude使用这些工具：

• "使用MCP工具：todoist_get_tasks，列出我今天的所有任务。"
• "在'工作'项目的'To Do'板块中创建任务'Review PR'"
• "为任务'Review PR'添加标签'重要'"
• "显示'工作'项目中所有带有'重要'标签的任务"
• "将任务'Documentation'移动到'进行中'板块"
• "将文档任务标记为完成"
• "给我一些建议，列出我今天可以去镇上购物时可以完成的任务。"
• "将任务X分解为更小的子任务，并添加截止日期x、y、z。"

贡献

欢迎贡献！请随时提交Pull Request。

许可证

本项目采用MIT许可证 - 详情请参阅LICENSE文件。

问题和支持

如果你遇到任何问题或需要支持，请在GitHub仓库中提交问题。