ClickUp MCP Server logo

ClickUp MCP Server

by v4lheru

This is an enhanced version of the ClickUp MCP Server that provides tools for AI assistants to interact with ClickUp. It adds new features and improves the architecture of the original ClickUp MCP Server.

View on GitHub

Last updated: N/A

What is ClickUp MCP Server?

The ClickUp MCP Server is a server that allows AI assistants to interact with ClickUp workspaces using the Model Context Protocol (MCP). This enhanced version adds new features like Task Relationships API support (dependencies, links, tags), Comments API support, and Checklists API support, along with architectural improvements for better maintainability and extensibility.

How to use ClickUp MCP Server?

The server can be deployed locally or on Railway. Once deployed, it can be connected to AI assistants like Claude by configuring a new MCP server with the server's URL and ClickUp API credentials. The AI assistant can then use the server's tools to interact with your ClickUp workspace.

Key features of ClickUp MCP Server

  • Task Dependencies Management

  • Task Links Management

  • Task Tags Management

  • Comprehensive Comments API

  • Task Checklists Management

  • Service-Based Architecture

  • Type-Driven Development

  • Railway Deployment Support

Use cases of ClickUp MCP Server

  • Automated Task Management

  • AI-Powered Project Updates

  • Intelligent Task Prioritization

  • Streamlined Workflow Automation

FAQ from ClickUp MCP Server

How do I set up the server locally?

Clone the repository, install dependencies with npm install, copy .env.example to .env and add your ClickUp API key and team ID, build the project with npm run build, and run the server with node build/index.js.

How do I deploy the server on Railway?

Fork or clone the repository to your GitHub account, create a new project on Railway from your GitHub repository, add the required environment variables (CLICKUP_API_KEY, CLICKUP_TEAM_ID) in Railway, and deploy the project.

How do I connect the server to Claude?

Open Claude Desktop app, go to Settings > MCP Servers, add a new MCP server with the provided configuration (command: curl, args: your Railway app URL, env: API key and team ID).

How do I add new tools to the server?

Define types in src/types/, implement service methods in src/services/, define tool schema in src/services/clickup-tools-integration.ts, implement tool handler in src/services/clickup-tools-integration.ts, and update the main server (if needed) in src/index.ts.

What are the benefits of using this enhanced version?

This version offers enhanced functionality with Task Relationships, Comments, and Checklist APIs, along with improved code architecture for easier maintenance and extension, making it more powerful and adaptable for various use cases.