AI导哈

任务管理协议服务器

一个集成Claude或任何MCP兼容LLM与Todoist的MCP服务器实现，通过自然语言实现任务管理。

  • by HitmanLy007
  • 本地部署
  • 更新于
在 GitHub 查看 hitmanly007/todoist-mcp-server-extended

使用说明

Todoist MCP服务器扩展

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

功能概述

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

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

快速安装指南

假设你已经安装了npm。

有关更全面的安装指南，请参阅 如何指导。

通过Smithery安装

通过以下方式安装Todoist MCP Server Extended for Claude Desktop 史密瑟里:

  1. 在cmd\pwsh中运行以下命令：
    npx -y @smithery/cli install @Chrusic/todoist-mcp-server-extended --client claude

通过将最后一个参数更改为 --client cline 或 --client windsurf

通过npm安装

  1. 在cmd\pwsh中运行以下命令：
    npm install -g @chrusic/todoist-mcp-server-extended

设置

获取Todoist API代币

  1. 登录到您的 Todoist帐户
  2. 引导到 Settings → Integrations
  3. 在下找到您的API令牌 Developer
  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服务器，并在下次客户端（重新）启动时加载工具。

示例用法

关于该问克劳德什么的一些简单建议。请注意，有时你必须 非常 直接让克劳德使用这些工具：

  • “使用MCP工具：todoist_get_tasks，列出我当天的所有任务。”
  • 在项目“工作”部分“待办事项”中创建任务“审查PR”
  • “将标签‘重要’添加到任务‘审查PR’中”
  • “在项目“工作”中显示标签为“重要”的所有任务”
  • 将任务“文档”移至“进行中”部分
  • “将文档任务标记为已完成”
  • “给我一些建议，让我今天在城里购物时可以完成列出的任务。”
  • 将任务X分解为更小的子任务，并添加截止日期X、y、z

贡献

欢迎投稿！请随时提交Pull Request。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

问题和支持

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

相关 MCP