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.5) 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

🔌 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.