mcp-clickup

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Enables interaction with ClickUp workspaces, providing tools to authenticate, retrieve tasks by ID or custom ID, and fetch multiple tasks at once from ClickUp projects.

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 列表
    • 返回:任务及其完整信息列表

设置

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

ClickUp API 的 MCP 服务器,

  1. Tools
    1. Setup
      1. Usage with Claude Desktop
      2. Troubleshooting
    2. Build
      1. License
        ID: xmkjx41v71