An MCP server for ClickUp that exposes most ClickUp v2/v3 operations as typed tools, including tasks, lists, spaces, docs, chat, goals, sprints, time tracking, custom fields, webhooks, guests, and more. It also provides a `clickup_raw` tool for direct access to uncovered API endpoints.
From the registry: The most complete ClickUp MCP server — 161 tools + clickup_raw for the full v2/v3 API.
Please install the `clickup-mcp-pro` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js** — Node.js is required to run the MCP server via npx. (https://nodejs.org/)
- **Create a ClickUp Personal API Token** — In ClickUp, go to Settings → Apps → API Token and generate a personal API token starting with pk_.
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","clickup-mcp-pro"]
- required environment variables:
- `CLICKUP_API_TOKEN`: ClickUp personal API token. The README notes CLICKUP_TOKEN is also accepted, but CLICKUP_API_TOKEN is the documented primary variable. (example: `<your-clickup-api-token>`)
- optional environment variables:
- `CLICKUP_TEAM_ID`: Default Team/Workspace ID used when a tool omits team_id. (example: `<your-clickup-team-id>`)
- `CLICKUP_READONLY`: Set to true to block all write operations while allowing reads. (example: `<true-or-false>`)
- `CLICKUP_DISABLE_RAW`: Set to true to hide the clickup_raw tool. (example: `<true-or-false>`)
- `CLICKUP_UPLOAD_DIR`: Base directory allowed for upload_task_attachment(file_path). (example: `<your-upload-directory>`)
- `CLICKUP_MAX_UPLOAD_BYTES`: Maximum attachment upload size in bytes. (example: `<max-upload-bytes>`)
- `CLICKUP_TIMEOUT_MS`: Per-request timeout in milliseconds. (example: `<timeout-ms>`)
- `CLICKUP_MAX_RETRIES`: Maximum retries for 429/5xx/network errors. (example: `<max-retries>`)
Note: Preferred install path is the npm package via npx. The README also documents running from source with node dist/index.js, but npx is the simplest portable option. Transport is stdio.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.CLICKUP_API_TOKENrequiredPersonal ClickUp API token used for authenticationCLICKUP_TOKENAlternate accepted name for the ClickUp API tokenAtlassian Rovo MCP Server