Todoist MCP Server Extended

这是一个实现了MCP（模型上下文协议）服务器，该服务器集成了Claude——或者任何兼容MCP的LLM，如果你愿意的话——与Todoist，通过MCP工具实现自然语言任务管理。此服务器中的工具允许Claude使用日常语言与你的Todoist任务、项目、部分和标签进行交互，同时优化了LLM工作流程的效率。

<a href="https://glama.ai/mcp/servers/xzuab11d38"><img width="380" height="200" src="https://glama.ai/mcp/servers/xzuab11d38/badge" alt="Todoist Server MCP服务器" /></a>

功能概述

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

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

快速安装指南

假设您已经安装了npm。

更详细的安装指南可以在如何指南中找到。

通过Smithery安装

要通过Smithery安装适用于Claude桌面的Todoist MCP Server Extended：

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桌面客户端

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

   "todoist": {
     "command": "npx",
     "args": ["-y", "@chrusic/todoist-mcp-server-extended"],
     "env": {
         "TODOIST_API_TOKEN": "PASTE-YOUR-API-TOKEN-HERE"
     }
   }
   

2. 当所有内容组合在一起时，它应该看起来像这样：

   {
   "mcpServers": {
       "todoist": {
       "command": "npx",
       "args": ["-y", "@chrusic/todoist-mcp-server-extended"],
       "env": {
           "TODOIST_API_TOKEN": "PASTE-YOUR-API-TOKEN-HERE"
       }
       }
   }
   }
   

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

示例用法

一些简单的建议，告诉Claude做什么。请注意，有时你需要非常直接地让Claude使用这些工具：

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

贡献

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

许可证

本项目根据MIT许可证发布 - 详情见LICENSE文件。

问题和支持

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