Todoist MCP Server

Todoist MCP 服务器扩展

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

功能概述

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

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

快速安装指南

假设您已经安装了 npm。

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

通过 Smithery 安装

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

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

通过将最后一个参数更改为--client cline或--client windsurf ，还可以与 cline 或 windsurf 兼容

通过 npm 安装

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

设置

获取 Todoist API 令牌

1. 登录您的Todoist 帐户
2. 导航至Settings → Integrations
3. 在Developer下找到您的 API 令牌
4. 按下Copy API Token

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

添加 MCP 服务器和 API 令牌 Claude 桌面客户端

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，列出我当天的所有任务。”
• 在项目‘工作’部分‘待办事项’中创建任务‘审核 PR’
• “为任务‘审核 PR’添加‘重要’标签”
• “显示项目‘工作’中所有带有‘重要’标签的任务”
• “将任务‘文档’移至‘进行中’部分”
• “将文档任务标记为完成”
• “我要去城里购物，请给我一些我今天可以做的列出任务的建议。”
• 将任务 X 分解为更小的子任务并添加截止日期 x、y、z。

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

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

问题与支持

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