Nsxdavid Clickup MCP Server

🚀 ClickUp MCP 服务器

一个模型上下文协议（MCP）服务器，为与 ClickUp API 交互提供标准接口。借助该服务器，AI 系统能够访问和操作 ClickUp 数据，涵盖工作区、空间、文件夹、列表、任务、文档、评论和检查表等。

🚀 快速开始

此模型上下文协议（MCP）服务器可提供与 ClickUp API 交互的标准接口，让 AI 系统访问和操作 ClickUp 数据。以下为你介绍使用前的准备工作。

✨ 主要特性

服务器提供了一系列实用工具，方便用户对 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

替代安装（使用 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 令牌。
• 使用此方法无需安装或克隆。

📚 详细文档

获取 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 令牌。

配置文件位置

• 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 License 保护。