
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)
概覽
在本機執行的 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 的網路。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Clickup Mcp,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
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:
Less tokens = faster responses, lower costs, more context for your AI.
Installation
Or run directly:
Configuration
Claude Code CLI
Claude Desktop / Manual
Add to your MCP config (~/.claude.json or Claude Desktop settings):
From Source
Then configure with the built path:
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
- Go to ClickUp Settings > Apps
- Generate a Personal API Token
- 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:
clickup_create_comment - from ~1,500 chars to 38:
What gets stripped:
Tools (40)
Navigation (7)
clickup_whoami- Current user + workspacesclickup_get_spaces- Spaces in workspaceclickup_get_folders- Folders in spaceclickup_get_lists- Lists in folder or spaceclickup_get_list- Single list detailsclickup_create_list- Create list in folder or spaceclickup_delete_list- Delete a list (permanent)
Task CRUD (5)
clickup_get_task- Get task by IDclickup_create_task- Create task with all fieldsclickup_update_task- Update any task fieldclickup_get_tasks- List tasks in a listclickup_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 tagsclickup_create_space_tag- Create tagclickup_edit_space_tag- Edit tagclickup_delete_space_tag- Delete tagclickup_add_tag_to_task- Tag a taskclickup_remove_tag_from_task- Untag a task
Checklists (6)
clickup_create_checklist- Create checklistclickup_edit_checklist- Edit checklistclickup_delete_checklist- Delete checklistclickup_create_checklist_item- Add itemclickup_edit_checklist_item- Edit itemclickup_delete_checklist_item- Delete item
Dependencies (4)
clickup_add_dependency- Add dependencyclickup_delete_dependency- Remove dependencyclickup_add_task_link- Link tasksclickup_delete_task_link- Unlink tasks
Comments (5)
clickup_create_comment- Add commentclickup_get_comments- Get commentsclickup_update_comment- Edit/resolve commentclickup_create_reply- Threaded replyclickup_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 alist_idinPUT /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 membersclickup_get_list_members- List-specific members
Architecture
License
MIT
來源:README.md,提交 fdb52d1
工具
0版本歷史
2- v1.1.0最新Oct 8, 2026
- v1.0.3Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分