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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides integration with ClickUp's API, allowing you to retrieve task information and manage ClickUp data through MCP-compatible clients.

Related MCP Servers

ClickUp MCP Server
Nazruden
A
security
A
license
A
quality
This server integrates AI assistants with ClickUp workspaces, enabling task, team, list, and board management through a secure OAuth2 authentication process.
Last updated -
5
21
12
TypeScript
MIT License
ClickUp MCP Server
taazkareem
A
security
A
license
A
quality
Enables AI integrations with ClickUp tasks, supporting resource management, task operations, workspace organization, and AI-powered task recommendations through a standardized protocol.
Last updated -
18
1,359
313
TypeScript
MIT License
mcp-clickup
mikah13
A
security
A
license
A
quality
MCP Server for the ClickUp API,
Last updated -
4
428
3
TypeScript
MIT License
ClickUp MCP Sedrver
nsxdavid
A
security
A
license
A
quality
ClickUp MCP Server enables AI assistants to seamlessly interact with your ClickUp workspace. This powerful integration allows Claude to create and manage tasks, access documents, organize folders and lists, add comments, and handle checklists—all through natural conversation.
Last updated -
42
487
20
TypeScript
MIT License

View all related MCP servers

ClickUp MCP Server