Todoist MCP 服务器扩展

一个 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 server" /></a>

功能概述

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

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

快速安装指南

假设您已经安装了 npm。

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

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 安装 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 Desktop Client

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

   "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 Desktop 客户端将在下次客户端（重新）启动时启动 MCP 服务器并加载工具。

使用示例

一些关于如何向 Claude 提问的简单建议。 请注意，有时您必须 非常 直接才能让 Claude 使用这些工具：

• "使用 MCP 工具：todoist_get_tasks，列出我今天的所有任务。"
• "在项目 'Work' 版块 'To Do' 中创建任务 'Review PR'"
• "将标签 'Important' 添加到任务 'Review PR'"
• "显示项目 'Work' 中带有标签 'Important' 的所有任务"
• "将任务 'Documentation' 移动到版块 'In Progress'"
• "将文档任务标记为已完成"
• "给我一些关于我今天可以做的已列出任务的建议，因为我要去城里购物。"
• "将任务 X 分解为更小的子任务并添加截止日期 x, y, z。"

贡献

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

许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。

问题和支持

如果您遇到任何问题或需要支持，请在 GitHub 存储库 上提交问题。