ClickUp MCP Server

基本能力

产品定位

ClickUp MCP Server 是一个中间件服务，旨在为 AI 助手提供与 ClickUp 项目管理平台的无缝集成能力。

核心功能

• 提供标准化的接口供 AI 助手与 ClickUp API 交互
• 支持对 ClickUp 数据的访问和操作
• 包含多种工具用于管理工作区、空间、文件夹、列表、任务等

适用场景

• AI 助手需要访问或管理 ClickUp 项目数据
• 自动化 ClickUp 工作流程
• 集成 ClickUp 数据到 AI 系统中

工具列表

• get_workspaces: 获取工作区列表
• get_spaces: 获取工作区内的空间
• get_tasks: 从列表中获取任务
• create_task: 创建新任务
• update_task: 更新现有任务
• get_docs_from_workspace: 从工作区获取所有文档
• create_folder: 在空间中创建新文件夹
• get_lists: 获取文件夹或空间中的列表
• create_list: 创建新列表

常见问题解答

• 需要有效的 ClickUp API 令牌才能使用
• 安装时需要正确配置路径和 API 令牌
• 支持两种安装方式：克隆仓库安装和使用 npx 直接运行

使用教程

使用依赖

• Node.js ≥18.0.0
• MCP SDK 1.6.1

安装教程

1. 克隆仓库并安装依赖：

git clone https://github.com/nsxdavid/clickup-mcp-server.git
cd clickup-mcp-server
npm install

1. 获取 ClickUp API 令牌：
2. 登录 ClickUp 账户
3. 转到 Settings > Apps
4. 点击 "Generate API Token"

5. 复制令牌

6. 配置 MCP 设置文件：

{
  "mcpServers": {
    "clickup": {
      "command": "node",
      "args": ["/path/to/clickup-mcp-server/build/index.js"],
      "env": {
        "CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

或者使用 npx 直接运行：

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": [
        "-y",
        "clickup-mcp-server"
      ],
      "env": {
        "CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

调试方式

1. 构建项目：

npm run build

1. 运行测试：

npm test

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。