ClickUp MCP 服务器

将 ClickUp 完美连接至 AI 代理，包括 Claude Desktop、Cursor IDE、n8n、Gemini CLI 等。 一个高性能的模型上下文协议（MCP）服务器，用于通过自然语言管理任务、标签、列表、文件夹、文件、文档、时间、聊天和工作流。

状态更新： v0.12.8：新增功能及改进，包括支持自定义任务类型、改进的全工作区搜索和模糊匹配、无需依赖的远程部署等。

⭐️ 性能验证： 460+ Stars（来自之前的公开仓库）和每周数千次 NPM 下载。AI 领域的行业标准 ClickUp 集成。

💎 高级访问

本项目采用赞助模式运营。 这个高性能 MCP 服务器每日维护，以确保与最新 AI 代理和 ClickUp API 变更的兼容性。许可证授予完全访问所有 50+ 工具、优先错误修复和企业级功能开发。

⚡️ 即时交付： 您的许可证密钥将通过Polar.sh立即发送。总设置时间不超过 2 分钟。

🚀 快速开始

1. 前提条件

• Node.js v18.0.0+
• ClickUp 凭证： API 密钥和团队 ID
• 许可证密钥： 在此购买

2. 本地配置

将以下内容添加到您的 claude_desktop_config.json 或类似的 MCP 设置文件中，以通过 npx 本地运行：

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

3. 托管/远程使用（测试版）

-或- 无需本地 Node.js 要求的零设置使用，使用托管版本：

{
  "mcpServers": {
    "ClickUp": {
      "serverUrl": "https://clickup-mcp.taazkareem.com/mcp",
      "headers": {
        "X-ClickUp-Key": "your-clickup-api-key",
        "X-ClickUp-Team-Id": "your-team-id",
        "X-License-Key": "your-license-key-here",
        "X-Enabled-Tools": "get_workspace_hierarchy,create_task,get_task,update_task,get_workspace_tasks"
      }
    }
  }
}

4. 重启

重启您的 MCP 主机（如 Cursor IDE）。服务器将验证您的许可证并自动启动。

✨ 功能

通过自然语言无缝集成 ClickUp，实现定制化工作流

• 📝 任务管理： 创建、更新、移动、复制和链接任务。支持批量操作和自然语言日期。
• ⏱️ 时间跟踪： 启动/停止计时器，查看条目和管理计费时间。
• 📄 文档与知识： 创建、读取和追加 ClickUp 文档。完整的工作区层次结构遍历。
• 💬 聊天与协作： 发送消息到频道，读取历史记录和管理支持 Markdown 的评论。
• 🌳 工作区控制： 导航空间、文件夹和列表。管理标签和成员分配。
• 🧠 智能归一化： 自动映射模糊状态名称（如 todo 与 to-do），并使用私有、会话隔离的缓存记住会话上下文以解析“它”或“那个任务”。

⚙️ 配置

查找您的凭证

1. ClickUp API 密钥：
   • 导航至 ClickUp 设置 → 应用。
   • 在“API 令牌”下生成一个令牌。
2. ClickUp 团队 ID：
   • 在浏览器中打开 ClickUp。
   • 查看 URL：https://app.clickup.com/[TEAM_ID]/v/...
   • 第一个数字是您的团队 ID。
   • 注意：ClickUp API 称之为 team_id，但实际上代表您的工作区 ID。

高级配置

过滤可用工具

通过限制 env 中的可用工具减少上下文噪音：

"ENABLED_TOOLS": "create_task,get_task,update_task,get_workspace_hierarchy"

启用文档支持（测试版）

启用 ClickUp 文档的创建和管理：

"DOCUMENT_SUPPORT": "true"

🛠️ 可用工具

🔌 兼容性

此服务器支持 STDIO、HTTP 可流式和 SSE（服务器发送事件） 以支持旧版集成。

配置：

{
  "env": {
    "ENABLE_SSE": "true",
    "PORT": "3231"
  }
}

n8n 设置：

1. 将 ENABLE_SSE 设置为 "true" 并运行服务器。
2. 在 n8n 中，添加一个 "MCP AI Tool" 节点。
3. 将传输设置为 SSE，URL 设置为 http://localhost:3231/sse。

❓ 常见问题

为什么不再免费？ 构建可靠的 MCP 集成需要大量维护工作。转向付费模式使我们能够将其作为产品而非爱好来支持，确保与 API 变更的兼容性。

我有旧版本。它会停止工作吗？ 现有的本地克隆将继续工作，但如果没有许可证，您将无法获得更新、错误修复或支持。

如何获得支持？ 高级用户获得优先支持。请在此仓库中提交问题。

⚖️ 免责声明

最初作为开源项目开发，并在与 ClickUp 的咨询期间进行了优化，现在由独立维护。

本软件使用第三方 API，并可能引用第三方拥有的商标或品牌。使用此类 API 或引用并不意味着与相应公司有任何关联或认可。所有商标和品牌名称均为其各自所有者的财产。本项目是独立作品，未与任何提及的第三方公司正式关联或由其赞助。