ClickUp MCP Server

Overview

🦾 A strong Model, Capability, Protocol (MCP) server for ClickUp API integration. This server provides a standardized interface for interacting with ClickUp's API through the MCP protocol, making it easier to build AI-enabled applications that leverage ClickUp's project management capabilities.

Related MCP server: ClickUp MCP Server

Features

• Multiple transport protocols (HTTP streaming and SSE)

• Environment variable configuration via .env files

• Consolidated data models for seamless API interaction

Python versions support

Requires Python 3.13 or higher.

Quick Start

Installation

pip install clickup-mcp-server

Running the server

The simplest way to start the server:

clickup-mcp-server --token YOUR_CLICKUP_API_TOKEN

Using environment files

You can store your API token in a .env file:

# .env file
CLICKUP_API_TOKEN=your_api_token_here

And start the server with:

clickup-mcp-server --env /path/to/.env

Client connection

Connect to the server using any MCP client implementation. Example:

• Using SSE transport

import asyncio
from mcp import ClientSession
from mcp.client.sse import sse_client

async def get_authorized_teams():
    url = "http://localhost:3005/sse"

    async with sse_client(url) as (read_stream, write_stream):
        async with ClientSession(read_stream, write_stream) as session:
            await session.initialize()

            tools = await session.list_tools()
            print("Available tools:", [tools])

            res = await session.call_tool(
                name="get_authorized_teams",
            )
            print("get_authorized_teams →", res.model_dump())

if __name__ == "__main__":
    asyncio.run(get_authorized_teams())

• Using streaming HTTP transport

import asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def get_authorized_teams():
    url = "http://localhost:3005/mcp/mcp"

    async with streamablehttp_client(url) as (
        read_stream,
        write_stream,
        _close_fn,
    ):
        async with ClientSession(read_stream, write_stream) as session:
            await session.initialize()

            tools_resp = await session.list_tools()
            print("Available tools:", [t.name for t in tools_resp.tools])

            res = await session.call_tool(
                name="get_authorized_teams",
            )
            print("get_authorized_teams →", res.model_dump())

if __name__ == "__main__":
    asyncio.run(get_authorized_teams())

API Resources

The server provides access to the following ClickUp resources:

• Teams

• Spaces

• Goals

• Key Results

Configuration Options

The server supports various configuration options:

Documentation

The documentation contains more details, demonstrations and anything you need about clickup-mcp-server.

• Getting start helps you start to prepare the environment, install dependencies and configure the detail settings with explanation in detail.

  • What requirement I need to prepare?

  • How can I install it?

  • How to configure the details for this MCP server?

  • I have a configuration right now. How can I run this MCP server?

• Want to learn more how to use it?

  • What exact features or APIs it has?

    • About the web APIs

    • About the MCP APIs

• Want to contribute to this project?

  • I face something issue it cannot work finely!

  • I want to wish a feature or something change.

  • If you're interested in clickup-mcp-server and have any ideas want to design it, even implement it, it's very welcome to contribute clickup-mcp-server!

• About the release notes.

Coding style and following rules

follows coding styles black and PyLint to control code quality.

Downloading state

clickup-mcp-server still a young open source which keeps growing. Here's its download state:

License

MIT License