ClickUp MCP Server

MCP Server for the ClickUp API, enabling Claude to interact with ClickUp workspaces.

Tools

1. `clickup_authenticate`

2. `clickup_get_task`

3. `clickup_get_task_by_custom_id`

4. `clickup_get_tasks`

Setup

1. Get your ClickUp API Token:

2. Get your Workspace ID:

Usage with Claude Desktop

Add the following to your `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"
      }
    }
  }
}

Troubleshooting

If you encounter errors, verify that:

1. Your API token is valid and has not expired

2. The workspace ID is correct

3. You have the necessary permissions in the ClickUp workspace

4. The task IDs you're trying to access exist and are accessible to you

Build

Docker build:

docker build -t mcp/clickup .

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.