Get the FREE Ultimate OpenClaw Setup Guide →

mcp -clickup

Model Context Protocol (MCP) server implementation for ClickUp integration

Installation
Run this command in your terminal to add the MCP server to Claude Code.
Run in terminal:
Command
claude mcp add --transport stdio noah-vh-mcp-server-clickup uvx clickup-operator

How to use

This MCP server implements a lightweight note storage system backed by a simple note:// URI scheme. Each stored note has a name, a description, and a text/plain mimetype, making it straightforward to access and reference individual notes. The server exposes a single prompt, summarize-notes, which generates summaries of all current notes. You can optionally pass a style parameter to control the level of detail (for example, brief or detailed). In addition, there is a single tool, add-note, which lets you add a new note by providing a name and content. When a note is added, the server updates its state and notifies connected clients of the resource changes. This combination of storage, retrieval, and summarization capabilities makes it easy to manage a compact knowledge base through MCP tooling and prompts.

How to install

Prerequisites:

  • Access to a Python environment and the UV/UVX tooling ecosystem as described in the project (uv/uvx commands).
  • Python 3.8+ installed and available on your PATH.

Installation steps:

  1. Clone the repository: git clone https://github.com/your-org/mcp-server-clickup-operator.git
  2. Navigate to the project directory: cd mcp-server-clickup-operator
  3. Install dependencies (via your preferred package manager): uv install

    or, if dependencies are managed via a requirements.txt or pyproject.toml, use your standard Python workflow

  4. Run the server in development mode (as suggested by the README examples): uv --directory C:\Users<your-username>\Documents\GitHub\clickup-operator run clickup-operator

    or use the published UVX approach:

    uvx clickup-operator
  5. Verify the server is running by checking the MCP Inspector or the server stdout for a ready signal.

Notes:

  • The exact directory paths in the commands should be adjusted to your local environment.
  • If using the MCP Inspector for debugging, install it via npm and run the provided debugging commands as shown in the README.

Additional notes

Tips and considerations:

  • The server uses stdio for MCP communication; debugging can be challenging, so leveraging the MCP Inspector is highly recommended.
  • When adding notes via add-note, ensure the note name is unique or handle collisions as per your application logic.
  • The environment may require proper configuration of any authentication or network access if you expose the server beyond localhost.
  • If you need to switch between development and published configurations, refer to the README's examples for uv vs uvx usage and adjust the mcpServers section accordingly.
  • For updating documentation or changes to the note schema, keep the note:// URI scheme and the note metadata (name, description, mimetype) in sync with your client tooling.

Related MCP Servers

Sponsor this space

Reach thousands of developers