Clickup Mcp Server

ClickUp MCP Server

clickup-mcp-server is a Python tool to set up MCP server easily and humanly.

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.

Features

[//]: # (- Full support for ClickUp API resources (Teams, Spaces, Folders, Lists, Tasks))

• Multiple transport protocols (HTTP streaming and SSE)
• Environment variable configuration via .env files
• Consolidated data models for seamless API interaction

Python versions support

[](https://pypi.org/project/clickup-mcp-server)

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

[//]: # (- Folders)

[//]: # (- Lists)

[//]: # (- Tasks)

[//]: # (- Users)

[//]: # (- Custom fields)

Configuration Options

The server supports various configuration options:

| Option | Environment Variable | Description | |-----------|----------------------|-------------------------------------------------| | --token | CLICKUP_API_TOKEN | Your ClickUp API token | | --env | - | Path to .env file containing configuration | | --port | - | Port to run the server on (default: 8000) | | --host | - | Host to bind the server to (default: 127.0.0.1) |

Documentation

[](https://chisanan232.github.io/clickup-mcp-server/)

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.

[](https://github.com/psf/black) [](https://github.com/pylint-dev/pylint)

Downloading state

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

[](https://pepy.tech/project/clickup-mcp-server) [](https://pepy.tech/project/clickup-mcp-server)

License

[MIT License](./LICENSE)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Chisanan232
• Source: Chisanan232/clickup-mcp-server
• License: MIT
• Homepage: https://chisanan232.github.io/clickup-mcp-server/

Install and usage instructions live in the source repository linked above.