Todoist MCP Server Extended

Todoist MCP Server Extended

一个 MCP（模型上下文协议）服务实现，可将 Claude（或任何兼容 MCP 的大模型，如果你擅长折腾的话）与 Todoist 集成，通过 MCP 工具实现自然语言任务管理。此服务中的工具允许 Claude 使用日常语言与 Todoist 任务、项目、分区和标签交互，同时针对大模型工作流效率进行了优化。

功能概览

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

如需查看可用工具的完整列表及其用法，请参阅 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. 前往 Settings → Integrations
3. 在 Developer 下找到你的 API 令牌
4. 点击 Copy API Token

如需了解更多 Todoist API 信息，请访问 Todoist 官方 API 文档。

在 Claude Desktop 客户端中添加 MCP 服务和 API 令牌

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’”
• “为任务‘Review PR’添加标签‘Important’”
• “显示项目‘Work’中所有带有标签‘Important’的任务”
• “将任务‘Documentation’移至‘In Progress’分区”
• “将文档任务标记为已完成”
• “我今天要去镇上购物，请给我一些已列出任务的建议，告诉我可以做哪些任务。”
• “将任务 X 拆分成更小的子任务，并添加截止日期 x、y、z。”

参与贡献

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

许可证

本项目采用 MIT License 授权，详情请参阅 LICENSE 文件。

问题与支持

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