JinDaGe - Chrusic_todoist-mcp-server-extended MCP Details

article

README

🚀 Todoist MCP 服务器增强版

这是一个集成Claude与Todoist的MCP（模型上下文协议）服务器实现，支持使用自然语言进行任务管理，让Claude能通过日常用语与你的Todoist任务、项目、部分和标签交互。

🚀 快速开始

Todoist MCP 服务器增强版允许Claude与Todoist进行交互，实现自然语言的任务管理。你可以通过以下步骤进行安装和配置。

✨ 主要特性

项目管理：创建、更新和管理Todoist项目。
部分组织：在项目中创建和管理部分。
任务管理：使用日常语言创建、更新、完成和删除任务。
标签管理：创建、更新和管理个人标签和任务标签。
智能搜索：通过部分名称匹配查找任务和标签。
灵活过滤：按项目、部分、截止日期、优先级和标签过滤任务。
丰富任务详情：支持描述、截止日期、优先级水平以及项目的分配。

完整的工具列表及其使用方法，请参阅 .docs 中的 tools.md。

📦 安装指南

通过Smithery安装

要通过 Smithery 自动安装Todoist扩展服务器：

npx -y @smithery/cli install @Chrusic/todoist-mcp-server-extended --client claude

手动安装

尚未在npm上发布。

🛠️ 设置

获取Todoist API令牌

登录你的Todoist账户。
进入设置 → 集成。
在“开发者”部分找到你的API令牌。

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

使用Cline配置MCP

将以下内容添加到你的Cline MCP设置文件中：

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["todoist-mcp-enhanced-server"],
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

💻 使用示例

基础用法

"在项目'工作'部分'待办'中创建任务'审查PR'"
"将标签'重要'添加到任务'审查PR'"
"显示项目'工作'中的所有带标签'重要'的任务"
"将任务'文档'移动到部分'进行中'"
"标记文档任务为完成"

👨‍💻 开发

从源代码构建

# 克隆仓库
git clone https://github.com/Chrusic/todoist-mcp-server-extended.git

# 进入目录
cd todoist-mcp-server-extended

# 安装依赖项
npm install

# 构建项目
npm run build

🤝 贡献

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

📄 许可证

此项目在 LICENSE 文件中详细说明下，使用MIT许可证发行。

❓ 问题与支持

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

Chrusic_todoist-mcp-server-extended