Skip to main content
Glama

clickup-mcp

ClickUp MCP server for Claude — exposes ClickUp tasks, spaces, folders, lists, and comments as MCP tools.

Tech stack: Python 3.12 + uv + FastMCP (Starlette/FastAPI)

Quick Start

# Install dependencies
cd D:\leo\mcp-server\clickup-mcp
uv sync

# Run in stdio mode (for Claude Desktop)
$env:CLICKUP_API_TOKEN="pk_xxxxx"
uv run clickup-mcp

Related MCP server: ClickUp MCP

Configuration

Copy .env.example to .env and fill in your values:

Variable

Default

Description

CLICKUP_API_TOKEN

ClickUp personal API token (pk_xxxxx)

AUTH_MODE

env

env = token from env var; gateway = token per-request from X-Clickup-Token header

MCP_TRANSPORT

stdio

stdio (Claude Desktop) or http (gateway)

MCP_HTTP_PORT

8080

HTTP server port

CLICKUP_BASE_URL

https://api.clickup.com/api/v2

API base URL

Get your API token: ClickUp → Settings → Apps → API Token

Claude Desktop Setup

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "clickup": {
      "command": "uv",
      "args": ["run", "--directory", "D:/leo/mcp-server/clickup-mcp", "clickup-mcp"],
      "env": {
        "CLICKUP_API_TOKEN": "pk_xxxxx"
      }
    }
  }
}

Transport Modes

stdio (Claude Desktop / CLI)

$env:CLICKUP_API_TOKEN="pk_xxxxx"
uv run clickup-mcp

HTTP — single-tenant

$env:CLICKUP_API_TOKEN="pk_xxxxx"
$env:MCP_TRANSPORT="http"
$env:MCP_HTTP_PORT="8080"
uv run clickup-mcp

HTTP — gateway / multi-tenant

$env:MCP_TRANSPORT="http"
$env:AUTH_MODE="gateway"
uv run clickup-mcp
# Each request must include: X-Clickup-Token: pk_xxxxx

Available Tools (22)

Tool

Description

clickup_get_workspaces

List all workspaces/teams

clickup_list_spaces

List spaces in a workspace

clickup_get_space

Get space details

clickup_get_space_folders

List folders in a space

clickup_get_space_lists

List folderless lists in a space

clickup_get_folder

Get folder details

clickup_get_folder_lists

List lists in a folder

clickup_create_folder

Create a folder

clickup_update_folder

Update a folder

clickup_delete_folder

Delete a folder

clickup_get_list

Get list details

clickup_create_list_in_folder

Create list in a folder

clickup_create_folderless_list

Create list in a space

clickup_update_list

Update a list

clickup_get_task

Get task by ID

clickup_search_tasks

Search tasks with filters

clickup_create_task

Create a task

clickup_update_task

Update a task

clickup_delete_task

Delete a task

clickup_move_task

Move task to a different list

clickup_get_task_comments

Get task comments

clickup_create_task_comment

Add a comment to a task

API Reference

Install Server
A
license - permissive license
A
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/MSPbotsAI/clickup-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server