Skip to main content
Version: Next

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:

  1. Create a .env file in your project directory:

    CLICKUP_API_TOKEN=your_clickup_api_token
  2. Specify the path to your .env file when starting the server:

    clickup-mcp-server --env /path/to/.env

Using Command-line Arguments

You can provide your API token directly as a command-line argument:

clickup-mcp-server --token your_clickup_api_token

Running the Server

Basic Usage

Start the server with default settings:

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:

For HTTP streaming (default)

clickup-mcp-server --transport http-streaming

For SSE

clickup-mcp-server --transport sse

Custom Port

Run the server on a specific port:

clickup-mcp-server --port 8080

Full Example

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.