MCP 服务器

ClickUp MCP Server

Enables AI applications to interact with ClickUp's project management API through the MCP protocol, supporting resources like Teams, Spaces, Goals, and Key Results.

README

<h1 align="center"> ClickUp MCP Server </h1>

</p>

<p align="center"> <em>clickup-mcp-server</em> is a Python tool to set up MCP server easily and humanly. </p>

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

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:

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

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.