Skip to main content
Glama

ClickUp MCP Integration

by Leanware-io

ClickUp MCP 集成

模型上下文协议服务器可与 ClickUp 无缝集成,允许大型语言模型与您的 ClickUp 工作区任务和数据进行交互。

可用工具

该 MCP 服务器提供以下与 ClickUp 交互的工具:

clickup_create_task

在您的 ClickUp 工作区中创建一个新任务。

  • 所需输入

    • name (字符串):任务名称

    • list_id (string):将创建任务的 ClickUp 列表 ID

  • 可选输入

    • markdown_description (string): markdown 格式的任务描述

    • priority (数字):任务优先级(1=紧急,2=高,3=正常,4=低)

    • due_date (数字):截止日期,以毫秒为单位的 Unix 时间戳

    • tags (字符串数组):要添加到任务的标签名称

    • time_estimate (数字):以毫秒为单位的时间估计

  • 返回:新创建任务的详细信息

clickup_get_task

使用 ID 检索有关特定任务的详细信息。

  • 所需输入

    • task_id (字符串):ClickUp 任务 ID

  • 返回:完整的任务详细信息,包括描述、状态、受让人和元数据

clickup_get_task_by_custom_id

使用自定义 ID 检索任务信息。

  • 所需输入

    • custom_id (字符串):任务的自定义ID

  • 返回:完整的任务详细信息,包括描述、状态、受让人和元数据

Related MCP server: ClickHouse MCP Server

建造

跑步:

npm i npm run build npm run inspector

Docker 构建:

docker buildx build -t {your-docker-repository} --platform linux/amd64,linux/arm64 . docker push {your-docker-repository}

设置

1.获取您的 ClickUp API 令牌:

  1. 登录您的 ClickUp 帐户,网址为app.clickup.com

  2. 点击左下角的个人资料图片,导航至用户设置

  3. 选择“设置”

  4. 点击左侧边栏中的“应用程序”

  5. 如果您还没有令牌,请点击“API 令牌”下的“生成”

  6. 复制生成的 API 令牌以用于 MCP 服务器配置

2. 查找您的工作区 ID:

  1. 在 Web 浏览器中打开 ClickUp

  2. 在工作区时查看 URL

  3. 工作区 ID 是 URL 中的数字值: https://app.clickup.com/{workspace_id}/home workspace_id}/home

  4. 复制此号码以用于 MCP 服务器配置

3.安装Docker: https://docs.docker.com/engine/install/

4a. 设置 Cline MCP 服务器:

  • 打开 VSCode 或 Jetbrains IDE 并转到 Cline。

  • 转到 MCP 服务器 → 已安装 → 配置 MCP 服务器。

  • 将以下内容添加到cline_mcp_settings.jsonmcpServers键内:

"clickup": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "CLICKUP_API_TOKEN", "-e", "CLICKUP_WORKSPACE_ID", "your-docker-repository" ], "env": { "CLICKUP_API_TOKEN": "your-api-token", "CLICKUP_WORKSPACE_ID": "your-workspace-id" } }

4b. 设置 Claude Desktop MCP 服务器:

  • 使用任何编辑器打开Claude Desktop的配置文件。

    • Windows: C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json

    • Mac: ~/Library/Application\ Support/Claude/claude_desktop_config.json

  • 将以下内容添加到claude_desktop_config.jsonmcpServers键内:

"clickup": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "CLICKUP_API_TOKEN", "-e", "CLICKUP_WORKSPACE_ID", "your-docker-repository" ], "env": { "CLICKUP_API_TOKEN": "your-api-token", "CLICKUP_WORKSPACE_ID": "your-workspace-id" } }
  • 保存配置文件

  • 重新启动 Claude Desktop 以应用更改

故障排除

如果您遇到 MCP 服务器问题:

  1. 身份验证错误

    • 验证您的 API 令牌是否正确

    • 确保 API 令牌具有执行您尝试的操作所需的权限

    • 检查你的工作区ID是否正确

  2. 任务访问问题

    • 确认您有权访问您尝试检索的任务

    • 验证任务 ID 是否正确并且存在于您的工作区中

    • 检查任务是否处于存档状态

  3. 连接问题

    • 确保您的 Docker 服务正常运行

    • 检查网络连接

    • 验证 MCP 配置中的环境变量是否正确设置

执照

此 MCP 服务器遵循 MIT 许可证。这意味着您可以自由使用、修改和分发该软件,但须遵守 MIT 许可证的条款和条件。

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Leanware-io/clickup-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server