
ClickUp MCP Pro
io.github.helbertparanhos由 GitHub 帳號 helbertparanhos 發布v1.0.0更新於 Oct 24, 2026
The most complete ClickUp MCP server — 161 tools + clickup_raw for the full v2/v3 API.
概覽
本機 MCP 伺服器,提供 161 個具型別工具與原始 API 通道,讓助理讀取並修改 ClickUp 工作區。
- 可以做什麼
- 讀取與管理工作區結構:團隊、空間、資料夾、清單、檢視、成員與使用者群組
- 建立、更新、刪除、複製、批次編輯與連結任務,包含子任務、檢查清單、標籤與自訂欄位
- 處理留言與討論串、附件、時間追蹤紀錄與任務範本
- 使用 v3 功能:文件與文件頁面、聊天頻道與訊息、目標與關鍵結果、衝刺、Webhook 與訪客
- 將名稱解析為 ID,並透過原始請求工具呼叫任何尚未包裝的 ClickUp v2/v3 端點
- 適用情境
- 適合需要助理直接在 ClickUp 內作業的情境,例如整理與批次修改任務、統計時間紀錄、撰寫文件或聊天訊息,或存取具型別工具未涵蓋的冷門端點。
- 執行需求
- 以 npm 套件形式透過 npx 在本機以 stdio 執行(需要 Node.js)。需在 CLICKUP_API_TOKEN 提供 ClickUp 個人 API 權杖(亦接受 CLICKUP_TOKEN);CLICKUP_TEAM_ID 為選用,作為預設工作區。需要連線至 ClickUp API 的網路。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 ClickUp MCP Pro,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
ClickUp MCP Pro
The most complete ClickUp MCP server — 161 typed tools +
clickup_rawcovering the entire ClickUp v2/v3 API. Built to match or beat the paid alternatives, free and open source.
[npm version] [License: MIT] [GitHub Stars] [GitHub Forks] [GitHub Issues] [Glama Quality]
[TypeScript] [Node.js] [MCP] [Claude Code] [Cursor] [Claude Desktop]
[Instagram] [YouTube] [LinkedIn] [Buy Me A Coffee] [Strat Academy]
ClickUp MCP Pro exposes nearly every ClickUp operation as a typed Model Context Protocol tool — so Claude Code (and any MCP client) can drive your entire workspace: tasks, lists, folders, spaces, docs, chat, goals, sprints, time tracking, custom fields, webhooks, guests and more. When a niche endpoint isn't wrapped, clickup_raw reaches the rest of the API directly, giving you 100% coverage.
Highlights
- 161 typed tools across 23 ClickUp domains (v2 + v3 APIs).
clickup_rawescape hatch — call any endpoint not yet wrapped. Nothing is out of reach.- Readonly mode (
CLICKUP_READONLY=true) blocks every write while keeping reads working — safe exploration. - Natural-language dates —
"tomorrow","in 3 days","+2h", ISO, or epoch ms all work for any date field. - Name → ID resolution —
find_member,find_space_by_name,find_list_by_name. - Resilient client — automatic retries with backoff on 429/5xx,
Retry-Afterhonored, actionable error messages. - Bulk operations with per-item success/error reporting (partial failures never lose the batch).
Coverage at a glance
Install & configure
1. Get a ClickUp Personal API Token
ClickUp → Settings → Apps → API Token (it starts with pk_).
2. Add to Claude Code
Or, running from source:
3. Claude Desktop
File: %APPDATA%\Claude\claude_desktop_config.json (Windows) or
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) — same mcpServers block as above.
Environment variables
Security notes
This server runs locally and acts on behalf of your token, so it's hardened against the usual ways a malicious prompt could abuse a tool call:
upload_task_attachment(url)only fetches HTTPS URLs and rejects hosts that resolve to private/loopback/link-local addresses (anti-SSRF), following no redirects.upload_task_attachment(file_path)can be confined to a directory withCLICKUP_UPLOAD_DIRto prevent arbitrary local-file exfiltration. Uploads are size-capped (CLICKUP_MAX_UPLOAD_BYTES). Note: don't place symlinks pointing outside the directory insideCLICKUP_UPLOAD_DIR.clickup_rawvalidates the path (must be a clean relative API path — no scheme, host,..or@) and is blocked for writes underCLICKUP_READONLY=true. SetCLICKUP_DISABLE_RAW=trueto remove it entirely in untrusted environments.- The API token is sent only as an auth header and is never logged or echoed in error messages.
Build from source
Tool reference
Workspace / Teams
get_workspaces, get_workspace_seats, get_workspace_plan, get_workspace_members, get_custom_task_types, get_authorized_user
Spaces
list_spaces, get_space, create_space, update_space, delete_space, get_space_tags
Folders
list_folders, get_folder, create_folder, create_folder_from_template, update_folder, delete_folder, get_folder_views
Lists
get_lists_in_folder, get_folderless_lists, get_list, create_list_in_folder, create_folderless_list, create_list_from_template_in_folder, update_list, delete_list, get_list_views
Tasks
get_tasks, get_task, get_workspace_tasks, create_task, update_task, delete_task, get_subtasks, duplicate_task, set_task_custom_field_value, remove_task_custom_field_value, get_task_members
Bulk: create_bulk_tasks, update_bulk_tasks, delete_bulk_tasks, move_bulk_tasks
Links & deps: add_task_link, delete_task_link, add_task_dependency, delete_task_dependency, add_task_to_list, remove_task_from_list
Comments
get_task_comments, create_task_comment, get_list_comments, create_list_comment, get_chat_view_comments, create_chat_view_comment, update_comment, delete_comment, get_threaded_comments, create_threaded_comment
Checklists
create_checklist, edit_checklist, delete_checklist, create_checklist_item, edit_checklist_item, delete_checklist_item
Attachments
upload_task_attachment (local path / URL / base64), list_task_attachments
Tags & Custom fields
get_space_tags, create_space_tag, update_space_tag, delete_space_tag, add_tag_to_task, remove_tag_from_task
get_list_custom_fields, get_folder_custom_fields, get_space_custom_fields, get_workspace_custom_fields, set_custom_field_value, remove_custom_field_value
Time tracking
get_time_entries, get_time_entry, get_running_time_entry, start_time_entry, stop_time_entry, create_time_entry, update_time_entry, delete_time_entry, get_time_entry_history, get_all_time_entry_tags, add_tags_to_time_entries, remove_tags_from_time_entries, get_task_time_in_status, get_bulk_tasks_time_in_status
Docs (v3)
search_docs, get_doc, create_doc, get_doc_page_listing, get_doc_pages, get_doc_page, create_doc_page, update_doc_page (replace/append/prepend)
Views
get_team_views, get_space_views, get_view, get_view_tasks, create_view, update_view, delete_view
Goals
get_goals, get_goal, create_goal, update_goal, delete_goal, create_key_result, update_key_result, delete_key_result
Chat (v3)
list_chat_channels, get_chat_channel, create_chat_channel, create_chat_channel_on_location, create_chat_direct_message, update_chat_channel, get_chat_channel_members, get_chat_channel_followers, get_chat_messages, send_chat_message, update_chat_message, delete_chat_message, get_chat_message_replies, create_chat_message_reply, get_chat_message_reactions, create_chat_message_reaction, delete_chat_message_reaction, get_chat_message_tagged_users
Sprints / Webhooks / User groups / Guests / Templates
list_sprints, get_active_sprint, get_sprint_tasks
list_webhooks, create_webhook, update_webhook, delete_webhook
list_user_groups, create_user_group, update_user_group, delete_user_group
invite_guest, get_guest, edit_guest, remove_guest, add_guest_to_task, remove_guest_from_task, add_guest_to_list, remove_guest_from_list, add_guest_to_folder, remove_guest_from_folder
get_task_templates, create_task_from_template
Members & resolvers
get_task_assignable_members, get_list_members, find_member, find_space_by_name, find_list_by_name
Escape hatch
clickup_raw — call any ClickUp v2/v3 endpoint directly. Example:
How it compares
License
MIT © Helbert Paranhos / Strat Academy
- GitHub: @helbertparanhos
- Built with the Strat Builder meta-system.
來源:README.md,提交 426c58f
工具
0版本歷史
1- v1.0.0最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分