ClickUp MCP Server

什么是 ClickUp MCP Server？

这个 ClickUp MCP 服务器是由 taazkareem 独立维护的商业 Model Context Protocol 服务器，让 AI 智能体用自然语言管理 ClickUp 的任务、列表、冲刺、文档、聊天、评论和工时记录，需要购买付费许可证。

该项目最初是开源的，后来转为付费模式。README 表示它曾在与 ClickUp 的咨询合作中得到完善，但现在独立维护，与 ClickUp 没有隶属或背书关系。许可证可解锁约 150 个工具。它既可以作为托管的远程服务器运行（https://clickup-mcp.taazkareem.com/mcp），也可以通过 npm 包 @taazkareem/clickup-mcp-server 以本地 stdio 方式运行。ClickUp 自己也提供官方 MCP 服务器，见下文。

如何使用 ClickUp MCP Server？

前置条件：

• 一个通过 Polar.sh 购买的许可证密钥（月付、年付或终身，每种都包含 3 次设备激活）。
• 仅本地 stdio 方式需要：ClickUp API token（ClickUp Settings > Apps，在“API Token”下点击 Generate），以及 Team ID，即工作区 URL 中 app.clickup.com/ 之后的第一个数字。远程方式两者都不需要。

远程服务器通过 X-License-Key 请求头加上对 ClickUp 账号的 OAuth 2.1 进行认证；本地方式则以环境变量传入 API 密钥、Team ID 和许可证密钥。

Claude Code

claude mcp add --transport http ClickUp https://clickup-mcp.taazkareem.com/mcp \
  --header "X-License-Key: your-license-key"

Claude Desktop

远程方式需要在 claude_desktop_config.json 中使用 mcp-remote 适配器：

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://clickup-mcp.taazkareem.com/mcp",
        "--header",
        "X-License-Key: your-license-key"
      ]
    }
  }
}

Cursor

添加到 <project-root>/.cursor/mcp.json（远程方式）：

{
  "mcpServers": {
    "ClickUp": {
      "url": "https://clickup-mcp.taazkareem.com/mcp",
      "headers": { "X-License-Key": "your-license-key" }
    }
  }
}

或通过 stdio 在本地运行：

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": ["-y", "@taazkareem/clickup-mcp-server@latest"],
      "env": {
        "CLICKUP_API_KEY": "your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id",
        "CLICKUP_MCP_LICENSE_KEY": "your-license-key"
      }
    }
  }
}

VS Code

在 .vscode/mcp.json（工作区）或用户级 mcp.json 中使用同样的远程或本地 JSON。

Codex

添加到 ~/.codex/config.toml：

[mcp_servers.ClickUp]
url = "https://clickup-mcp.taazkareem.com/mcp"
http_headers = { "X-License-Key" = "your-license-key" }

README 还介绍了 Windsurf、Roo Code、Augment、n8n、ChatGPT、Antigravity 和 Hermes 的配置。针对 n8n 提供了自托管 Docker 镜像：docker run -d -p 3231:3231 ghcr.io/taazkareem/clickup-mcp-server:latest。

ClickUp MCP Server 的主要功能

• 混合认证：OAuth 2.1，支持会话隔离缓存，并向后兼容 API 密钥与 Team ID。
• 全局模糊搜索：覆盖任务、列表、文件夹和空间名称、自定义字段、成员、状态和标签，AI 很少需要使用原始 ID。
• 完整的任务管理：增删改查、移动、复制、关联、依赖、批量操作、子任务、清单、自定义字段、模板和附件。
• 工时记录：计时器、手动录入、编辑历史，以及按自然语言日期在整个工作区筛选。
• 支持 markdown 页面的 ClickUp Docs，以及带线程回复和表情回应的评论和聊天频道。
• 目标与关键结果、视图、Webhook、标签，以及层级中各级别的访问控制。
• 通过额外的 API 密钥在一个会话中支持多个工作区。
• 可按名称、类别或角色（persona）筛选工具，减少上下文噪音。

ClickUp MCP Server 工具

获得许可证后，服务器提供约 150 个工具，按类别分组：

• 任务：create_task、update_task、move_task、create_bulk_tasks、get_workspace_tasks（深度搜索）、add_task_dependency 以及任务关联。
• 评论、清单与附件：create_comment、create_comment_reply、create_checklist、create_checklist_item、upload_attachment。
• 冲刺与结构：get_active_sprint、list_sprints，以及空间、文件夹和列表的创建、更新和移动工具，包括 set_list_permissions。
• 工时记录：start_time_entry、stop_time_entry、add_time_entry、get_time_entries、get_time_in_status。
• 文档与聊天：create_document、update_document_page、create_chat_message、create_chat_message_reply。
• 目标、视图、Webhook 与管理：create_goal、create_key_result、create_view、create_webhook、用户组、访客，以及 get_audit_logs（Enterprise）。

如需限制智能体可见的工具，本地方式可设置 ENABLED_TOOLS / ENABLED_CATEGORIES，远程方式可使用 X-Enabled-Tools / X-Enabled-Categories 请求头。也可以通过 CLICKUP_MCP_PERSONA 或 X-Persona 选择角色，例如 auditor（只读）、task_worker、project_manager 或 safe_power_user（除破坏性删除外的全部工具）。

ClickUp MCP Server 的使用场景

• 在聊天中规划工作：“把 Q3 发布拆分成一个列表，包含子任务和负责人。”
• 检查冲刺状态：“审查 Sprint 看板，报告有哪些风险。”
• 不离开编辑器就记录工时：“给登录 bug 任务开始计时”，然后“给昨天的代码评审记录 45 分钟”。
• 保持文档最新：“把今天的发布说明追加到 Engineering Changelog 文档。”
• 跨工作区整理任务，例如在两个已授权的 ClickUp 账号之间移动或复制任务。
• 使用 auditor 角色运行只读的报告型智能体。

ClickUp MCP Server 与替代方案对比

ClickUp 自己的官方 MCP 服务器记录在 ClickUp 帮助中心，由 ClickUp 托管；如果你想要厂商支持的连接，它是自然的首选。taazkareem 的这个服务器是付费的第三方方案，主打超大的工具集、角色、工具筛选和多工作区会话。其他项目管理工具可参考 Asana MCP Server、Linear MCP Server 或 Trello MCP Server。

ClickUp MCP Server 常见问题排查

• 旧的免费版本不再获得修复：早期版本仍能运行，但没有许可证就不会收到更新、bug 修复或支持。
• 远程方式不接受许可证：确认请求头严格为 X-License-Key: your-license-key；Claude Desktop 需要通过 mcp-remote 适配器才能发送该请求头。
• 本地 stdio 无法访问工作区：检查 CLICKUP_API_KEY 和 CLICKUP_TEAM_ID；Team ID 是 URL 中 app.clickup.com/ 之后的第一个数字。
• 工具太多挤占上下文：用 ENABLED_CATEGORIES 或 task_worker 等角色进行筛选。
• n8n 无法连接 Docker：URL 使用 http://host.docker.internal:3231/mcp。