ClickUp MCP Server

<p align="center"> <img src="assets/images/clickupserverlogo.png" width="256" alt="ClickUp MCP Server Logo" /> </p> <p align="center"> <a href="https://www.npmjs.com/package/clickup-mcp-server"><img src="https://img.shields.io/npm/v/clickup-mcp-server.svg" alt="npm 版本"></a> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="许可证：MIT"></a> <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen" alt="Node.js 版本"></a> <a href="https://github.com/modelcontextprotocol/typescript-sdk"><img src="https://img.shields.io/badge/MCP%20SDK-1.6.1-orange" alt="MCP SDK"></a> </p>

这是一个提供标准化接口供AI助手与ClickUp API交互的Model Context Protocol (MCP)服务器。此服务器使AI系统能够访问和操作ClickUp数据，如工作区、空间、文件夹、列表、任务、文档、评论和检查清单。

可用工具

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

安装

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

获取ClickUp API令牌

1. 登录到ClickUp账户
2. 前往设置 > 应用
3. 点击“生成API令牌”
4. 复制令牌

配置

添加到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": []
    }
  }
}

• 确保路径正确
• 确保提供您的API令牌

替选安装方法（npx）

对于不想克隆仓库的用户，可以直接使用npx运行该包：

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

• 将YOUR_API_TOKEN_HERE替换为您的API令牌
• 使用这种方法无需安装或克隆

配置文件位置

• Cline VSCode扩展：~/.vscode/extensions/saoudrizwan.claude-dev/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Claude桌面应用：
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

开发

构建

npm run build

运行测试

npm test

许可证

MIT