ClickUp MCP 服务器

用于 ClickUp API 的 MCP 服务器，使 Claude 能够与 ClickUp 工作区进行交互。

工具

1. clickup_authenticate

   • 使用 API 令牌和工作区 ID 通过 ClickUp API 进行身份验证

   • 必需输入：

     • api_token （字符串）：用于身份验证的 ClickUp API 令牌

     • workspace_id （字符串）：用于身份验证的 ClickUp 工作区 ID

   • 返回：用户信息和认证状态

2. clickup_get_task

   • 通过任务 ID 从 ClickUp 检索任务

   • 必需输入：

     • api_token （字符串）：用于身份验证的 ClickUp API 令牌

     • task_id (string): 要检索的 ClickUp 任务的 ID

   • 返回：详细的任务信息，包括描述、状态和元数据

3. clickup_get_task_by_custom_id

   • 通过自定义 ID 从 ClickUp 检索任务

   • 必需输入：

     • api_token （字符串）：用于身份验证的 ClickUp API 令牌

     • custom_id （字符串）：要检索的 ClickUp 任务的自定义 ID

     • workspace_id （字符串）：API 请求所需的工作区 ID

   • 返回：详细的任务信息，包括描述、状态和元数据

4. clickup_get_tasks

   • 根据 ID 从 ClickUp 中检索多个任务

   • 必需输入：

     • api_token （字符串）：用于身份验证的 ClickUp API 令牌

     • workspace_id （字符串）：ClickUp 工作区 ID

     • task_ids (string[]): 要检索的任务 ID 列表

   • 返回：任务及其完整信息列表

Related MCP server: ClickHouse MCP Server

设置

1. 获取您的 ClickUp API 令牌：

   • 登录您的 ClickUp 帐户

   • 前往“设置”→“应用程序”

   • 点击“生成 API 令牌”

   • 复制您的 API 令牌

2. 获取您的工作区 ID：

   • 在浏览器中打开 ClickUp

   • 工作区 ID 位于 URL 中： https://app.clickup.com/{workspace_id}/home workspace_id}/home

   • 这是一个以数字开头的数字

与 Claude Desktop 一起使用

将以下内容添加到您的claude_desktop_config.json中：

NPX

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-clickup"
      ],
      "env": {
        "CLICKUP_API_TOKEN": "your-api-token",
        "CLICKUP_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

码头工人

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

故障排除

如果遇到错误，请验证：

1. 您的 API 令牌有效且未过期

2. 工作区 ID 正确

3. 您拥有 ClickUp 工作区所需的权限

4. 您尝试访问的任务 ID 存在且您可以访问

建造

Docker 构建：

docker build -t mcp/clickup .

执照

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。