Clickup Mcp

io.github.cvrt-jh由 GitHub 帳號 cvrt-jh 發布v1.1.0更新於 Oct 27, 2026

Lightweight ClickUp MCP server - 37 tools, token-optimized (95% smaller responses)

已驗證STDIO僅桌面效率與工作流溝通與協作

概覽

AI 產生的概覽

在本機執行的 ClickUp MCP 伺服器,提供約 40 個任務管理工具,並精簡回應以節省 token。

可以做什麼
  • 瀏覽工作區結構:目前使用者與工作區、空間、資料夾、清單,並可建立或刪除清單
  • 管理任務:取得、建立、更新、列出、搜尋和刪除任務,設定自訂欄位值,將任務加入或移出附加清單
  • 以標籤和檢查清單整理:建立、編輯、刪除空間標籤,為任務加上或移除標籤,管理檢查清單及其項目
  • 處理相依性與關聯:新增或移除任務相依性和任務連結
  • 處理留言:建立、讀取、編輯或解決留言,張貼或讀取串接回覆
  • 上傳本機檔案作為任務附件,並查詢工作區或清單成員
適用情境
適合讓助理在對話中讀取和修改 ClickUp 的任務、清單、標籤、檢查清單和留言;若在意 token 成本尤其合適,因為 ClickUp 原始 API 回應非常冗長。
執行需求
透過 npx 或全域 npm 安裝,以 stdio 在本機執行(需要 Node.js)。需在 CLICKUP_API_TOKEN 環境變數提供 ClickUp 個人 API Token。若 Token 可存取多個工作區,還需設定 CLICKUP_TEAM_ID。需要能連線至 ClickUp API 的網路。
安裝前請注意
README 標明此專案已不再維護、停止開發。API Token 可存取你的 ClickUp 工作區,請勿放入共用設定。許多工具會寫入或永久刪除資料(任務、清單、標籤、檢查清單、相依性、留言),上傳附件會把本機檔案傳送到 ClickUp。多清單歸屬需要 ClickUp 付費功能,且任務無法真正在清單間移動。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Clickup Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

clickup-mcp

Unmaintained. ClickUp is retired at CAVORT (2026-10-18, cutover to Console complete). This server is kept as is and no longer developed.

[npm version] [License: MIT] [MCP SDK]

Lightweight ClickUp MCP server focused on task management. 40 tools with token-optimized responses - API responses automatically slimmed from thousands of characters to essentials.

Why This Server?

ClickUp's API returns extremely verbose JSON. This server strips it down:

ResponseBeforeAfterReduction
clickup_whoami~3,500 chars~160 chars95%
clickup_create_comment~1,500 chars~38 chars97%

Less tokens = faster responses, lower costs, more context for your AI.

Installation

bash
npm install -g @cavort-it-systems/clickup-mcp

Or run directly:

bash
npx @cavort-it-systems/clickup-mcp

Configuration

Claude Code CLI

bash
claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- npx @cavort-it-systems/clickup-mcp

Claude Desktop / Manual

Add to your MCP config (~/.claude.json or Claude Desktop settings):

json
{  "mcpServers": {    "clickup": {      "command": "npx",      "args": ["@cavort-it-systems/clickup-mcp"],      "env": {        "CLICKUP_API_TOKEN": "your-token"      }    }  }}

From Source

bash
git clone https://github.com/cvrt-jh/clickup-mcp.gitcd clickup-mcppnpm install && pnpm build

Then configure with the built path:

bash
claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- node /path/to/clickup-mcp/build/index.js

Custom task IDs

Every tool that takes a task_id accepts the custom ID as well (DEV-1217), not only the internal one (86caqr85m). The server adds custom_task_ids=true&team_id=... itself. The workspace id comes from CLICKUP_TEAM_ID, or, if unset, from the token's only workspace (looked up once). A token with access to several workspaces must set CLICKUP_TEAM_ID.

Get Your API Token

  1. Go to ClickUp Settings > Apps
  2. Generate a Personal API Token
  3. Set as CLICKUP_API_TOKEN

Response Slimming

All responses are automatically trimmed to save tokens. The ClickUp API returns extremely verbose JSON - this server strips it down to what matters.

clickup_whoami - from ~3,500 chars to ~160:

json
// Before (ClickUp API raw){"user":{"id":12345678,"username":"Jane Doe","email":"[email protected]","color":"#0388d1","profilePicture":"https://attachments.clickup.com/...","initials":"JD","week_start_day":1,"global_font_support":true,"timezone":"Europe/Berlin"},"teams":{"teams":[{"id":"99999999","name":"My Workspace","color":"#40BC86","avatar":"https://attachments2.clickup.com/...?Expires=...&Key-Pair-Id=...&Signature=...","members":[{"user":{"id":11111111,"username":"Bob Smith","email":"[email protected]","color":"#aa2fff","profilePicture":null,"initials":"BS","role":4,"role_subtype":2,"role_key":"guest","custom_role":null,"last_active":"...","date_joined":"...","date_invited":"..."},"invited_by":{"id":22222222,...},"can_see_time_spent":true,...}, ...]}]}}
// After (slimmed){"id":12345678,"username":"Jane Doe","email":"[email protected]","timezone":"Europe/Berlin","workspaces":[{"id":"99999999","name":"My Workspace","member_count":4}]}

clickup_create_comment - from ~1,500 chars to 38:

json
// Before{"id":90150191300876,"hist_id":"...","date":1770053982842,"version":{"object_type":"comment","object_id":"...","workspace_id":99999999,"operation":"c","data":{"context":{"root_parent_type":1,"is_chat":false,"audit_context":{"userid":12345678,"current_time":...,"route":"*"},...},...},...}}
// After{"id":90150191300876,"date":1770053982842}

What gets stripped:

FieldWhereWhy
features{}spaces~50 lines of boolean flags per space
sharing{}, permission_leveltasksInternal access config, not useful
watchers[]tasksUsually same as assignees
Full user objectseverywhereReduced to {id, username, email}
profilePicture, initials, colorusersVisual metadata, not useful for LLMs
version{} blobscomment/reply createsInternal versioning data
invited_by, profileInfomembersInvitation metadata
Pretty-print JSONall responsesCompact single-line output
Empty arraystaskschecklists, dependencies, custom_fields omitted when empty

Tools (40)

Navigation (7)

  • clickup_whoami - Current user + workspaces
  • clickup_get_spaces - Spaces in workspace
  • clickup_get_folders - Folders in space
  • clickup_get_lists - Lists in folder or space
  • clickup_get_list - Single list details
  • clickup_create_list - Create list in folder or space
  • clickup_delete_list - Delete a list (permanent)

Task CRUD (5)

  • clickup_get_task - Get task by ID
  • clickup_create_task - Create task with all fields
  • clickup_update_task - Update any task field
  • clickup_get_tasks - List tasks in a list
  • clickup_search_tasks - Search tasks across workspace

Custom Fields (1)

  • clickup_set_custom_field - Set custom field value

Tags (6)

  • clickup_get_space_tags - List space tags
  • clickup_create_space_tag - Create tag
  • clickup_edit_space_tag - Edit tag
  • clickup_delete_space_tag - Delete tag
  • clickup_add_tag_to_task - Tag a task
  • clickup_remove_tag_from_task - Untag a task

Checklists (6)

  • clickup_create_checklist - Create checklist
  • clickup_edit_checklist - Edit checklist
  • clickup_delete_checklist - Delete checklist
  • clickup_create_checklist_item - Add item
  • clickup_edit_checklist_item - Edit item
  • clickup_delete_checklist_item - Delete item

Dependencies (4)

  • clickup_add_dependency - Add dependency
  • clickup_delete_dependency - Remove dependency
  • clickup_add_task_link - Link tasks
  • clickup_delete_task_link - Unlink tasks

Comments (5)

  • clickup_create_comment - Add comment
  • clickup_get_comments - Get comments
  • clickup_update_comment - Edit/resolve comment
  • clickup_create_reply - Threaded reply
  • clickup_get_replies - Get replies

Delete Task (1)

  • clickup_delete_task - Delete a task

Multi-List Membership (2)

  • clickup_add_task_to_list - Add a task to an additional list (multi-homing)
  • clickup_remove_task_from_list - Remove a task from an additional list

These do not move a task. The ClickUp v2 API has no move-between-lists endpoint. Verified against the live API 2026-08-12: POST /list/{list}/task/{task} adds a secondary location and leaves the home list unchanged, while a list_id in PUT /task/{id} returns HTTP 200 and is silently ignored. To genuinely move a task and keep its custom ID and history, use the ClickUp web UI (right-click -> Move). Multi-list membership also requires the paid Tasks-in-Multiple-Lists feature.

Attachments (1)

  • clickup_upload_attachment - Upload a local file (screenshot, PDF) to a task

Workspace Members (2)

  • clickup_get_workspace_members - All workspace members
  • clickup_get_list_members - List-specific members

Architecture

src/  index.ts          # Entry: McpServer + StdioServerTransport  client.ts         # ClickUp API v2 fetch wrapper  types.ts          # Shared Zod schemas + jsonResult helper  slim.ts           # Response slimming transformers  tools/    navigation.ts   # 7 tools    tasks.ts        # 9 tools (CRUD + custom fields + delete + multi-list)    tags.ts         # 6 tools    checklists.ts   # 6 tools    dependencies.ts # 4 tools    comments.ts     # 5 tools    members.ts      # 2 tools    attachments.ts  # 1 tool (multipart upload)

License

MIT

來源:README.md,提交 fdb52d1

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

2
  1. v1.1.0最新Oct 8, 2026
  2. v1.0.3Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分