taazkareem/clickup-mcp-server

ClickUp MCP Server — Premium

---

Properly Connect ClickUp to AI Agents and Agentic Workflows

A high-performance Model Context Protocol (MCP) server for managing tasks, checklists, sprints, comments, tags, spaces, lists, folders, files, docs, chat, and time using natural language.

⭐️ Proven Performance: 460+ Stars (from previous public repo) & thousands of weekly NPM downloads.
The industry-standard ClickUp integration for AI.

---

📚 Table of Contents

---

✨ Features

🔥 Multi-Account Support: Manage multiple authorized workspaces seamlessly in a single session. See setup

---

💎 Premium Access

---

🚀 Quick Start

1. Prerequisites

• License Key: See above

• ClickUp API Key (Optional - not needed for Remote MCP)

  • Log into ClickUp and go to ClickUp Settings → Apps.
  • Click Generate under “API Token” (or copy your existing one).

• ClickUp Team ID (Optional - not needed for Remote MCP)

  • Open ClickUp in your browser.
  • Look at the URL: https://app.clickup.com/1234567/v/li/987654321.
  • The first number (1234567) directly after clickup.com/ is your Team ID (Workspace ID).

2. Choose your MCP Host & Transport

3. Restart

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

---

🛠️ Available Tools

---

⚙️ Advanced Configuration

Filter Available Tools

💡 Pro Tip! Reduce context noise for the AI by limiting available tools. There are 3 ways to do this. You can filter by exact tool name, by tool category, by personas (presets), or a combination of all three.

Local (Environment Variable):

"ENABLED_TOOLS": "tool_1,tool_2,tool_3",
"ENABLED_CATEGORIES": "task,time_tracking,workspace"

-or- Hermes (YAML):

mcp_servers:
  clickup:
    env:
      ENABLED_TOOLS: "tool_1,tool_2,tool_3"
      ENABLED_CATEGORIES: "task,time_tracking,workspace"

-or- Remote (Header):

"X-Enabled-Tools": "tool_1,tool_2,tool_3",
"X-Enabled-Categories": "task,time_tracking,workspace"

Preset Configurations

Simplify setup by using Personas. You can set a persona via the CLICKUP_MCP_PERSONA environment variable or the X-Persona HTTP header to automatically filter a set of tools.

Multiple personas can be combined (e.g., "X-Persona": "task_worker,time_specialist").

Local (Environment Variable):

"CLICKUP_MCP_PERSONA": "task_worker"

-or- Remote (Header):

"X-Persona": "task_worker"

💡 Need to customize? To view the exact tools included in each preset or to build a custom list based on a persona, see the Personas Reference Guide.

---

🌍 Multi-Workspace Support

Simultaneously federate OAuth and multiple API keys to manage tasks across different authorized ClickUp accounts/workspaces in a single session. Easily move or duplicate tasks between workspaces, configure AI Agents for cross-workspace automation, and more.

Remote (Headers):

{
  "mcpServers": {
    "ClickUp": {
      "url": "https://clickup-mcp.taazkareem.com/mcp",
      "headers": {
        "X-License-Key": "your-license-key",
        "X-ClickUp-Additional-Keys": "shared_ws_api_key1,shared_ws_api_key2"
      }
    }
  }
}

---

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

---

⚖️ Disclaimer

Originally developed as open source and refined during a consultancy with ClickUp, this project is now independently maintained.

This software makes use of third-party APIs and may reference trademarks or brands owned by third parties. The use of such APIs or references does not imply any affiliation with or endorsement by the respective companies. All trademarks and brand names are the property of their respective owners. This project is an independent work and is not officially associated with or sponsored by any third-party company mentioned.

By using this software, you agree to our Terms of Service and acknowledge our Privacy Policy.