mcp -clickup
Model Context Protocol (MCP) server implementation for ClickUp integration
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:
- Clone the repository: git clone https://github.com/your-org/mcp-server-clickup-operator.git
- Navigate to the project directory: cd mcp-server-clickup-operator
- 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
- 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 - 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
mcp-vegalite
MCP server from isaacwasserman/mcp-vegalite-server
github-chat
A Model Context Protocol (MCP) for analyzing and querying GitHub repositories using the GitHub Chat API.
nautex
MCP server for guiding Coding Agents via end-to-end requirements to implementation plan pipeline
pagerduty
PagerDuty's official local MCP (Model Context Protocol) server which provides tools to interact with your PagerDuty account directly from your MCP-enabled client.
futu-stock
mcp server for futuniuniu stock
mcp -boilerplate
Boilerplate using one of the 'better' ways to build MCP Servers. Written using FastMCP