ClickUp API服务

ClickUp MCP Server是一个通过API与ClickUp工作空间交互的服务,提供任务管理和认证功能。

  • by mikah13
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 mikah13/mcp-clickup

使用说明

点击MCP服务器

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

工具

  1. clickup_authenticate

    • 使用API令牌和工作区ID使用ClickUp API进行身份验证
    • 所需输入:
      • api_token (字符串):用于身份验证的ClickUp API令牌
      • workspace_id (string):点击工作区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 (string):要检索的ClickUp任务的自定义ID
      • workspace_id (字符串):API请求所需的工作区ID
    • 返回:详细的任务信息,包括描述、状态和元数据
  4. clickup_get_tasks

    • 按ID从ClickUp检索多个任务
    • 所需输入:
      • api_token (字符串):用于身份验证的ClickUp API令牌
      • workspace_id (string):点击工作区ID
      • task_ids (string[]):要检索的任务ID列表
    • 返回:任务列表及其完整信息

设置

  1. 获取您的ClickUp API代币:

    • 登录您的ClickUp帐户
    • 转到“设置”→ Apps
    • 点击“生成API令牌”
    • 复制您的API令牌
  2. 获取您的工作区ID:

    • 在浏览器中打开ClickUp
    • 工作区ID位于URL中: https://app.clickup.com/{workspace_id}/home
    • 这是一个以数字开头的数字

使用Claude Desktop

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

新巴拿马型船舶

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