ClickUp Operator

Model Context Protocol (MCP) server implementation for ClickUp integration

python

5

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "noah-vh-mcp-server-clickup": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\noahv\\Documents\\GitHub\\create-python-server\\clickup-operator",
        "run",
        "clickup-operator"
      ]
    }
  }
}

This MCP server implements the ClickUp operator as an MCP server, enabling note storage, simple prompts, and a minimal toolset that can be controlled from an MCP client. It is useful for testing, prototyping, and integrating ClickUp-related workflows with an MCP-driven client interface.

How to use

Use an MCP client to connect to the ClickUp operator MCP server and perform operations such as listing notes, adding notes, and generating summaries. The server exposes a note storage system with a custom note:// URI scheme and a single summarize-notes prompt that can create summaries of all stored notes. You can add notes with the add-note tool and then trigger summaries to see combined results.

How to install

Prerequisites: ensure you have a supported runtime that can run MCP servers via stdio (the MCP runtime used here is uv/uvx). You will also need Node.js or Python if you plan to build or develop further, but for running the server via MCP you only need the MCP runtime commands provided below.

Install and run steps based on the README's quickstart sections:

uv --directory C:\Users\noahv\Documents\GitHub\clickup-operator run clickup-operator

Configuration and debugging

The README includes development and published configurations for the ClickUp operator MCP server. Development uses uv with a specific directory and command, while published servers use uvx to run the server by name. The MCP Inspector can be used to debug MCP servers by launching a browser-based UI.

{
  "mcpServers": {
    "clickup-operator": {
      "type": "stdio",
      "name": "clickup-operator-dev",
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\noahv\\Documents\\GitHub\\create-python-server\\clickup-operator",
        "run",
        "clickup-operator"
      ]
    }
  }
}

{
  "mcpServers": {
    "clickup-operator": {
      "type": "stdio",
      "name": "clickup-operator-published",
      "command": "uvx",
      "args": [
        "clickup-operator"
      ]
    }
  }
}

Available tools

mcp_inspector

MCP Inspector provides a debugging UI and URL to inspect MCP servers during development and troubleshooting.