How to Run ClickUp MCP Server
This guide explains how to run and configure the ClickUp MCP Server after installation.
Configuration
Before running the server, you need to set up your ClickUp API token. You have several options:
Using a .env File (Recommended)
-
Create a
.env
file in your project directory:CLICKUP_API_TOKEN=your_clickup_api_token
-
Specify the path to your
.env
file when starting the server:- pip
- poetry
- uv
clickup-mcp-server --env /path/to/.env
poetry run clickup-mcp-server --env /path/to/.env
uv run clickup-mcp-server --env /path/to/.env
Using Command-line Arguments
You can provide your API token directly as a command-line argument:
- pip
- poetry
- uv
clickup-mcp-server --token your_clickup_api_token
poetry run clickup-mcp-server --token your_clickup_api_token
uv run clickup-mcp-server --token your_clickup_api_token
Running the Server
Basic Usage
Start the server with default settings:
- pip
- poetry
- uv
clickup-mcp-server
poetry run clickup-mcp-server
uv run clickup-mcp-server
This will start the server with HTTP streaming transport on port 8000.
Specifying Transport Type
You can choose between HTTP streaming and Server-Sent Events (SSE) transport:
- pip
- poetry
- uv
For HTTP streaming (default)
clickup-mcp-server --transport http-streaming
For SSE
clickup-mcp-server --transport sse
For HTTP streaming (default)
poetry run clickup-mcp-server --transport http-streaming
For SSE
poetry run clickup-mcp-server --transport sse
For HTTP streaming (default)
uv run clickup-mcp-server --transport http-streaming
For SSE
uv run clickup-mcp-server --transport sse
Custom Port
Run the server on a specific port:
- pip
- poetry
- uv
clickup-mcp-server --port 8080
poetry run clickup-mcp-server --port 8080
uv run clickup-mcp-server --port 8080
Full Example
- pip
- poetry
- uv
clickup-mcp-server --env /path/to/.env --transport sse --port 8080
poetry run clickup-mcp-server --env /path/to/.env --transport sse --port 8080
uv run clickup-mcp-server --env /path/to/.env --transport sse --port 8080
Verifying Server Operation
Once the server is running, you can verify it's working by accessing:
curl http://localhost:8000/health
You should receive a JSON response confirming the server is operational.