Clickup MCP Sedrver

🚀 ClickUp MCP 服務器

一個模型上下文協議（MCP）服務器，為 AI 助手提供與 ClickUp API 交互的標準接口。藉助此服務器，AI 系統能夠訪問和操作 ClickUp 數據，涵蓋工作區、空間、文件夾、列表、任務、文檔、評論和檢查表等。

🚀 快速開始

本服務器允許 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）

對於不想克隆倉庫的用戶，可以直接使用 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 許可證。