Integrations
Allows AI assistants to interact with ClickUp workspaces through the Model Context Protocol (MCP). Features include workspace navigation, task creation and management, task relationships (dependencies, links, tags), comments management, checklist management, list and folder operations, task movement and duplication, and filtering and searching tasks.
Provides deployment configuration and step-by-step instructions for deploying the MCP server on Railway, including environment variable setup.
ClickUp MCP Server with Supergateway
This integration runs the ClickUp MCP server through Supergateway, exposing it as an SSE endpoint that can be used by n8n nodes or other clients.
Prerequisites
- Node.js 18 or higher
- Docker and Docker Compose (for containerized deployment)
- ClickUp API key and Team ID
Local Development
Running with Node.js
- Install dependencies:Copy
- Set environment variables:Copy
- Run the integration script:Copy
- Customize configuration (optional):Copy
Running with Docker Compose
- Create a
.env
file based on.env.example
:Copy - Edit the
.env
file with your ClickUp API key and Team ID. - Start the container:Copy
- View logs:Copy
Deployment to Railway
- Create a new project on Railway.
- Connect your GitHub repository or use the Railway CLI to deploy.
- Set the following environment variables in Railway:
CLICKUP_API_KEY
: Your ClickUp API keyCLICKUP_TEAM_ID
: Your ClickUp Team IDPORT
: 8000 (or your preferred port)BASE_URL
: Your Railway app URL (e.g., https://your-app-name.up.railway.app)SSE_PATH
: /sse (or your preferred path)MESSAGE_PATH
: /message (or your preferred path)LOG_LEVEL
: info (or debug for more verbose logging)DOCUMENT_SUPPORT
: false (or true if needed)CORS_ORIGINS
: * (or a comma-separated list of allowed origins)
- Deploy the application.
Usage with n8n
- In n8n, add a new "MCP" node.
- Configure the node with the following settings:
- Server URL: Your Railway app URL + SSE path (e.g., https://your-app-name.up.railway.app/sse)
- Message Path: Your message path (e.g., /message)
- Select the desired ClickUp tool from the available tools.
- Configure the tool parameters as needed.
- Connect the node to your workflow.
API Endpoints
- SSE Endpoint:
{BASE_URL}{SSE_PATH}
(e.g., http://localhost:8000/sse)- Method: GET
- Description: Subscribe to server-sent events
- Message Endpoint:
{BASE_URL}{MESSAGE_PATH}
(e.g., http://localhost:8000/message)- Method: POST
- Description: Send messages to the server
- Content-Type: application/json
- Body: JSON-RPC 2.0 formatted message
- Healthcheck Endpoint:
{BASE_URL}/healthz
(e.g., http://localhost:8000/healthz)- Method: GET
- Description: Check if the service is running correctly
- Response: "ok" if the service is healthy
Troubleshooting
- Connection Issues: Ensure your firewall allows connections to the specified port.
- Authentication Errors: Verify your ClickUp API key and Team ID are correct.
- CORS Errors: Configure the CORS_ORIGINS environment variable to include your client's origin.
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
An enhanced Model Context Protocol server that enables AI assistants to interact with ClickUp workspaces, supporting task relationships, comments, checklists, and workspace management through natural language.
Related Resources
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that enables AI agents to interact with ClickUp workspaces, allowing task creation, management, and workspace organization through natural language commands.Last updated -203MIT License
- -securityAlicense-qualityA Model Context Protocol server that enables Large Language Models to interact with ClickUp workspace tasks and data, allowing creation and retrieval of tasks through natural language.Last updated -59TypeScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that provides persistent task management capabilities for AI assistants, allowing them to create, update, and track tasks beyond their usual context limitations.Last updated -1TypeScript
- -securityFlicense-qualityA Model Context Protocol server that enables AI agents to generate, fetch, and manage UI components through natural language interactions.Last updated -102TypeScript