sksudeepvarma/clickup-mcp

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

1. Clone the repository:

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

2. Install dependencies using UV:

   uv sync
   

   Or using pip:

   pip install -r requirements.txt
   

3. 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

1. Log in to your ClickUp account
2. Go to Settings → Apps
3. Click Generate to create a new API token
4. 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