返回 MCP 目录
public公开dns本地运行

Chrusic_todoist-mcp-server-extended

Todoist MCP服务器增强版是一个实现模型上下文协议(MCP)的服务,将Claude与Todoist集成,支持用自然语言管理任务、项目、分区和标签。

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令牌

  1. 登录你的Todoist账户。
  2. 进入设置 → 集成。
  3. 在“开发者”部分找到你的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仓库 上提交问题。

smithery 徽章

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端