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

Using with MCP Clients

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

Example Usage

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

Project Structure

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