ClickUp MCP Server

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

工具

1. clickup_authenticate

   • 使用 API 令牌和工作区 ID 验证 ClickUp API
   • 必需输入：
     • api_token (string): 用于身份验证的 ClickUp API 令牌
     • workspace_id (string): 用于身份验证的 ClickUp 工作区 ID
   • 返回：用户信息和身份验证状态

2. clickup_get_task

   • 通过任务 ID 从 ClickUp 检索任务
   • 必需输入：
     • api_token (string): 用于身份验证的 ClickUp API 令牌
     • task_id (string): 要检索的 ClickUp 任务的 ID
   • 返回：包括描述、状态和元数据的详细任务信息

3. clickup_get_task_by_custom_id

   • 通过自定义 ID 从 ClickUp 检索任务
   • 必需输入：
     • api_token (string): 用于身份验证的 ClickUp API 令牌
     • custom_id (string): 要检索的 ClickUp 任务的自定义 ID
     • workspace_id (string): API 请求所需的工作区 ID
   • 返回：包括描述、状态和元数据的详细任务信息

4. clickup_get_tasks

   • 通过任务 ID 列表从 ClickUp 检索多个任务
   • 必需输入：
     • api_token (string): 用于身份验证的 ClickUp API 令牌
     • workspace_id (string): ClickUp 工作区 ID
     • task_ids (string[]): 要检索的任务 ID 列表
   • 返回：包含完整信息的任务列表

设置

1. 获取您的 ClickUp API Token：

   • 登录到您的 ClickUp 帐户
   • 进入设置 → 应用程序
   • 点击“生成 API 令牌”
   • 复制您的 API 令牌

2. 获取您的工作区 ID：

   • 在浏览器中打开 ClickUp
   • 工作区 ID 在 URL 中：https://app.clickup.com/{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"
      }
    }
  }
}

docker

{
  "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 文件。