ClickUp MCP Server

A Model Context Protocol (MCP) server that provides integration with ClickUp's API, allowing you to retrieve task information and manage ClickUp data through MCP-compatible clients.

Features

Task Retrieval: Get detailed information about specific ClickUp tasks
List Management: Retrieve all tasks within a ClickUp list
Comments Access: Fetch comments and discussion threads from tasks

Available Tools

`get_task(taskID: str)`

Retrieves comprehensive details about a specific ClickUp task including:

Task name, description, and status
Assignee information and due dates
Priority levels and custom fields
Creation and modification timestamps

`get_tasks_by_listId(listID: str)`

Fetches all tasks within a specified ClickUp list, providing:

Complete task overview for project management
Status tracking across multiple tasks
Assignment and progress monitoring
Workload distribution analysis

`get_comments(taskID: str)`

Retrieves all comments and discussion threads from a specific task:

Complete comment history with timestamps
Author information and reply threads
Communication context and decision tracking

Prerequisites

Python 3.11 or higher
ClickUp API token
UV package manager (recommended) or pip

Installation

Clone the repository:

git clone https://github.com/sksudeepvarma/clickup-mcp.git
cd clickup-mcp-python

Install dependencies using UV:

uv sync

Or using pip:

pip install -r requirements.txt

Set up your ClickUp API token:

Create a .env file in the project root:

CLICKUP_API_TOKEN=your_clickup_api_token_here

Or set the environment variable directly:

# Windows
set CLICKUP_API_TOKEN=your_clickup_api_token_here

# Linux/macOS
export CLICKUP_API_TOKEN=your_clickup_api_token_here

Getting Your ClickUp API Token

Log in to your ClickUp account
Go to Settings → Apps
Click Generate to create a new API token
Copy the token and add it to your environment variables

Usage

Running the MCP Server

python main.py

Using with MCP Clients

Configure your MCP client (like Claude Desktop) to use this server by adding it to your MCP configuration:

{
	"servers": {
		"clickup-mcp": {
			"type": "stdio",
			"command": "python",
			"args": ["path/to/clickup-mcp-python/main.py"],
			"env": {
				"CLICKUP_API_TOKEN": "${env:CLICKUP_API_TOKEN}"
			}
		}
	}
}

Example Usage

Once connected to an MCP client, you can use the tools like:

# Get details about a specific task
get_task("86cyecyvu")

# Get all tasks in a list
get_tasks_by_listId("901607370347")

# Get comments from a task
get_comments("86cyecyvu")

Project Structure

clickup-mcp-python/
├── main.py           # Main MCP server implementation
├── utilities.py      # Helper functions for API token validation
├── pyproject.toml    # Project dependencies and configuration
├── uv.lock          # Locked dependency versions
├── README.md        # This file
└── .vscode/
    └── mcp.json     # VS Code MCP configuration

Dependencies

mcp[cli]: Model Context Protocol implementation
requests: HTTP library for API calls
python-dotenv: Environment variable management

Security

API tokens are managed through environment variables
No sensitive data is logged or stored
Secure HTTPS communication with ClickUp API