ClickUp MCP Pro

ClickUp MCP Pro

最全面的 ClickUp MCP 服务——161 个类型化工具 + clickup_raw，覆盖完整的 ClickUp v2/v3 API。旨在媲美甚至超越付费替代方案，免费且开源。

ClickUp MCP Pro 将几乎所有 ClickUp 操作封装为类型化的 Model Context Protocol 工具，让 Claude Code（以及任何 MCP 客户端）都能操作你的整个工作区：任务、列表、文件夹、空间、文档、聊天、目标、冲刺、时间跟踪、自定义字段、Webhook、访客等。如果某个小众端点尚未封装，clickup_raw 可以直接调用 API 的其余部分，实现 100% 覆盖。

亮点

• 161 个类型化工具，覆盖 23 个 ClickUp 领域（v2 + v3 API）。
• clickup_raw 备用方案——调用尚未封装的任何端点，触达 API 的每个角落。
• 只读模式（CLICKUP_READONLY=true）会阻止所有写入操作，同时保留读取功能，便于安全探索。
• 自然语言日期——任何日期字段均支持 "tomorrow"、"in 3 days"、"+2h"、ISO 格式或 epoch 毫秒。
• 名称 → ID 解析——find_member、find_space_by_name、find_list_by_name。
• 高韧性客户端——遇到 429/5xx 时自动退避重试，遵循 Retry-After，并提供可采取行动的错误消息。
• 批量操作，逐项报告成功或错误（部分失败不会导致批次数据丢失）。

覆盖范围一览

领域	工具	领域	工具
工作区 / 团队	6	时间跟踪	14
空间	5	文档（v3）	8
文件夹	7	视图	7
列表	9	目标与关键结果	8
任务（核心）	11	聊天（v3）	18
任务（批量）	4	冲刺	3
任务链接与依赖项	6	Webhook	4
评论与讨论串	10	用户组	4
检查清单	6	访客（Enterprise）	10
附件	2	成员与解析器	5
标签	6	模板	2
自定义字段	6	clickup_raw	1

安装与配置

1. 获取 ClickUp 个人 API 令牌

ClickUp → Settings → Apps → API Token（以 pk_ 开头）。

2. 添加到 Claude Code

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["-y", "clickup-mcp-pro"],
      "env": {
        "CLICKUP_API_TOKEN": "pk_your_token_here",
        "CLICKUP_TEAM_ID": "9007012345"
      }
    }
  }
}

或者从源代码运行：

{
  "mcpServers": {
    "clickup": {
      "command": "node",
      "args": ["d:/GitHub/easypanel-mcp/projects/clickup-mcp-pro/dist/index.js"],
      "env": { "CLICKUP_API_TOKEN": "pk_your_token_here" }
    }
  }
}

3. Claude Desktop

文件：%APPDATA%\Claude\claude_desktop_config.json（Windows）或 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）——使用与上述相同的 mcpServers 配置块。

环境变量

变量	必需	默认值	描述
CLICKUP_API_TOKEN	✅	—	个人 API 令牌（pk_...）。也接受 CLICKUP_TOKEN。
CLICKUP_TEAM_ID	—	—	当工具未提供 team_id 时使用的默认团队 / 工作区 ID。
CLICKUP_READONLY	—	false	true 会阻止所有写入操作（仍可读取）。
CLICKUP_DISABLE_RAW	—	false	true 会隐藏 clickup_raw 工具。
CLICKUP_UPLOAD_DIR	—	—	将 upload_task_attachment(file_path) 限制在此基础目录内。
CLICKUP_MAX_UPLOAD_BYTES	—	52428800	上传附件的最大大小（50 MB）。
CLICKUP_TIMEOUT_MS	—	60000	每个请求的超时时间。
CLICKUP_MAX_RETRIES	—	3	遇到 429 / 5xx / 网络错误时的最大重试次数。

安全说明

此服务在本地运行，并使用你的令牌执行操作，因此针对恶意提示词滥用工具调用的常见方式进行了加固：

• upload_task_attachment(url) 只获取 HTTPS URL，并拒绝解析到私有 / 环回 / 链路本地地址的主机（防止 SSRF），且不跟随重定向。
• upload_task_attachment(file_path) 可通过 CLICKUP_UPLOAD_DIR 限定在某个目录中，以防止任意本地文件外泄。上传大小受限（CLICKUP_MAX_UPLOAD_BYTES）。注意：不要在 CLICKUP_UPLOAD_DIR 中放置指向目录之外的符号链接。
• clickup_raw 会验证路径（必须是干净的相对 API 路径——不得包含协议、主机、.. 或 @），并且在 CLICKUP_READONLY=true 时禁止写入操作。在不受信任的环境中，设置 CLICKUP_DISABLE_RAW=true 可彻底移除此工具。
• API 令牌只会作为身份验证标头发送，绝不会记录日志，也不会在错误消息中回显。

从源代码构建

cd projects/clickup-mcp-pro
npm install
npm run build
# Inspect interactively:
npm run inspector

工具参考

工作区 / 团队

get_workspaces、get_workspace_seats、get_workspace_plan、get_workspace_members、get_custom_task_types、get_authorized_user

空间

list_spaces、get_space、create_space、update_space、delete_space、get_space_tags

文件夹

list_folders、get_folder、create_folder、create_folder_from_template、update_folder、delete_folder、get_folder_views

列表

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

任务

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 批量：create_bulk_tasks、update_bulk_tasks、delete_bulk_tasks、move_bulk_tasks 链接与依赖项：add_task_link、delete_task_link、add_task_dependency、delete_task_dependency、add_task_to_list、remove_task_from_list

评论

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

清单

create_checklist、edit_checklist、delete_checklist、create_checklist_item、edit_checklist_item、delete_checklist_item

附件

upload_task_attachment（本地路径 / URL / base64）、list_task_attachments

标签和自定义字段

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

时间跟踪

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

文档（v3）

search_docs、get_doc、create_doc、get_doc_page_listing、get_doc_pages、get_doc_page、create_doc_page、update_doc_page（替换 / 追加到末尾 / 追加到开头）

视图

get_team_views、get_space_views、get_view、get_view_tasks、create_view、update_view、delete_view

目标

get_goals、get_goal、create_goal、update_goal、delete_goal、create_key_result、update_key_result、delete_key_result

聊天（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

冲刺 / Webhook / 用户组 / 访客 / 模板

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

成员和解析器

get_task_assignable_members、get_list_members、find_member、find_space_by_name、find_list_by_name

备用通道

clickup_raw — 直接调用任意 ClickUp v2/v3 端点。示例：

{ "method": "GET", "path": "/team/9007012345/space", "version": "v2" }

对比

	ClickUp MCP Pro	taazkareem（付费）	Nazruden	DiversioTeam
类型化工具	161	~150	~30	~28
原始备用通道	✅	—	—	—
只读模式	✅	—	—	—
聊天 / 目标 / 冲刺	✅	✅	—	—
文档（v3）	✅	✅	✅	—
时间跟踪	✅	✅	—	部分支持
价格	免费 / MIT	付费	免费	免费

许可证

MIT © Helbert Paranhos / Strat Academy

• GitHub：@helbertparanhos
• 基于 Strat Builder 元系统构建。