ClickUp MCP Server

Connect ClickUp to AI Agents including Claude Desktop, Cursor IDE, n8n, and Gemini CLI. A high-performance Model Context Protocol (MCP) server for managing tasks, tags, lists, folders, files, docs, time, and chat using natural language.

Status Update: Latest (v0.12.4) update fixes Markdown Description support for the get_task tool to intelligently improve High-Fidelity Context.

⭐️ 460+ Stars (from previous public repo) - Industry-Standard ClickUp MCP Integration

💎 Premium Access

This project operates on a Sponsorware model. To ensure dedicated maintenance, rapid API updates, and priority support, the source code and latest builds are exclusively available to supporters.

Instant Access: Licenses are delivered immediately via Polar.sh. Setup takes < 2 minutes.

🚀 Quick Start

1. Prerequisites

• Node.js v18.0.0+
• License Key: Purchase here
• ClickUp Credentials: API Key & Team ID

2. Configure MCP Client

Add the following to your claude_desktop_config.json or similar MCP settings file:

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": [
        "-y",
        "@taazkareem/clickup-mcp-server@latest"
      ],
      "env": {
        "CLICKUP_MCP_LICENSE_KEY": "your-license-key-here",
        "CLICKUP_API_KEY": "your-clickup-api-key",
        "CLICKUP_TEAM_ID": "your-team-id",
        "DOCUMENT_SUPPORT": "true"
      }
    }
  }
}

3. Restart

Restart your MCP Host (e.g., Cursor IDE). The server will validate your license and start automatically.

✨ Features

Integrate ClickUp seamlessly with Natural Language for customized workflows

• 📝 Task Management: Create, update, move, duplicate, and link tasks. Supports bulk operations and natural language dates.
• ⏱️ Time Tracking: Start/stop timers, view entries, and manage billable time.
• 📄 Docs & Knowledge: Create, read, and append to ClickUp Documents. Full workspace hierarchy traversal.
• 💬 Chat & Collaboration: Send messages to channels, read history, and manage comments with Markdown support.
• 🌳 Workspace Control: Navigate spaces, folders, and lists. Manage tags and member assignments.

⚙️ Configuration

Finding Your Credentials

1. ClickUp API Key:
   • Navigate to ClickUp Settings → Apps.
   • Generate a token under "API Token".
2. ClickUp Team ID:
   • Open ClickUp in your browser.
   • Look at the URL: https://app.clickup.com/[TEAM_ID]/v/...
   • The first number is your Team ID.
   • Note: ClickUp API calls this team_id, but it actually represents your Workspace ID.

Tool Filtering (Optional)

Reduce context noise by limiting available tools. Add this to your env configuration:

"ENABLED_TOOLS": "create_task,get_task,update_task,get_workspace_hierarchy"

🛠️ Available Tools

👇 Click to view all 50+ available tools

See full documentation for parameters and advanced usage.

🔌 Compatibility

This server supports STDIO, HTTP Streamable, and SSE (Server-Sent Events) for legacy integrations.

Configuration:

{
  "env": {
    "ENABLE_SSE": "true",
    "PORT": "3231"
  }
}

n8n Setup:

1. Set ENABLE_SSE to "true" and run the server.
2. In n8n, add an "MCP AI Tool" node.
3. Set Transport to SSE and URL to http://localhost:3231/sse.

❓ FAQ

Why isn't this free anymore? Building reliable MCP integrations requires significant maintenance. Moving to a paid model allows us to support this as a product rather than a hobby, ensuring compatibility with API changes.

I have an old version. Will it stop working? Existing local clones will continue to work, but you will not receive updates, bug fixes, or support without a license.

How do I get support? Premium users get priority support. Please open an issue in this repository.

Created by taazkareem

This project is an independent work and is not officially associated with or sponsored by ClickUp.