<h1 align="center">ClickUp MCP Server — Premium</h1>

<p align="center">

</p>

<p align="center">
<a href="https://www.npmjs.com/package/@taazkareem/clickup-mcp-server"></a>
<a href="https://www.npmjs.com/package/@taazkareem/clickup-mcp-server"></a>



<a href="https://github.com/TaazKareem/clickup-mcp-server/graphs/commit-activity"></a>
</p>

---

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

| Links | Quick Start & Installation |
| :--- | :--- |
| •&nbsp;Features<br>•&nbsp;Premium&nbsp;Access<br>•&nbsp;Available&nbsp;Tools<br>•&nbsp;Adv.&nbsp;Config<br>•&nbsp;FAQ<br>•&nbsp;Disclaimer | <table border="0" style="border: none; border-collapse: collapse; width: 575px;"> <tr style="border: none;"> <td width="140" style="border: none; vertical-align: middle; white-space: nowrap;"> Antigravity</td> <td width="155" style="border: none; vertical-align: middle; white-space: nowrap;"> Agy&nbsp;CLI</td> <td width="140" style="border: none; vertical-align: middle; white-space: nowrap;"> Hermes</td> <td width="140" style="border: none; vertical-align: middle; white-space: nowrap;"> OpenClaw</td> </tr> <tr style="border: none;"> <td style="border: none; vertical-align: middle; white-space: nowrap;"> Cursor</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"> VS&nbsp;Code</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"> Claude</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"> ClaudeCode</td> </tr> <tr style="border: none;"> <td style="border: none; vertical-align: middle; white-space: nowrap;"> n8n</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"> Codex</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"> ChatGPT</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"> Augment</td> </tr> <tr style="border: none;"> <td style="border: none; vertical-align: middle; white-space: nowrap;"> Auggie</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"> Windsurf</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"> Roo&nbsp;Code</td> <td style="border: none; vertical-align: middle; white-space: nowrap;">➕ Add Agent</td> </tr> </table> |

---

<a name="features"></a>✨ Features

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

<table border="0" style="width: 100%; border-collapse: collapse;">
<tr style="border: none;">
<td width="50%" style="vertical-align: top; border: none; padding-bottom: 20px;">
<strong>🔐 Hybrid Authentication</strong><br>
MCP spec-compliant OAuth 2.1 with advanced security hardening and session-isolated caching for fast, secure multi-tenant operation. Backwards compatible with API Key/Team ID(s).
</td>
<td width="50%" style="vertical-align: top; border: none; padding-bottom: 20px;">
<strong>🔍 Intelligent Search & Resolution</strong><br>
Smart tiered, global fuzzy search across task, list, folder, and space names, custom fields, members/emails, statuses, tags, descriptions, and more. Automatic resolution—no IDs needed.
</td>
</tr>
<tr style="border: none;">
<td style="vertical-align: top; border: none; padding-bottom: 20px;">
<strong>📝 Task Management</strong><br>
Full CRUD, move, duplicate, link, and set dependencies between tasks. Supports bulk operations, nested subtasks, checklists, sprints (active detection), natural language dates, custom task IDs, custom task types, custom fields, task templates, and file attachments (upload via URL, local path, or base64).
</td>
<td style="vertical-align: top; border: none; padding-bottom: 20px;">
<strong>⏱️ Time Tracking</strong><br>
Start/stop timers, log manual entries, edit existing entries, retrieve timer history, manage time entry tags, and filter time entries across the entire workspace using natural language dates or date ranges.
</td>
</tr>
<tr style="border: none;">
<td style="vertical-align: top; border: none; padding-bottom: 20px;">
<strong>📄 Document Management</strong><br>
Create, read, and append to ClickUp Docs with full markdown text. Manage pages within documents for structured, long-form content (consolidated action-based tool).
</td>
<td style="vertical-align: top; border: none; padding-bottom: 20px;">
<strong>💬 Comments & Chat</strong><br>
Post, edit, resolve, and reply to comments on tasks, lists, and views. Create and manage chat channels (including DMs), send messages with threaded replies, reactions, and follower management. Both support rich text, subtypes, and @mentions.
</td>
</tr>
<tr style="border: none;">
<td style="vertical-align: top; border: none; padding-bottom: 20px;">
<strong>🎯 Goals & Key Results</strong><br>
Create and manage Goals with full lifecycle support—create, update, delete, and archive. Define and track nested Key Results to measure OKR progress across the workspace.
</td>
<td style="vertical-align: top; border: none; padding-bottom: 20px;">
<strong>📋 Views</strong><br>
Create, list, update, and delete views at any level of the workspace hierarchy—space, folder, or list. Fetch tasks scoped to a specific view for focused filtering.
</td>
</tr>
<tr style="border: none;">
<td style="vertical-align: top; border: none;">
<strong>🗂️ Task Templates</strong><br>
Browse available task templates and instantly create tasks from them. Streamlines repeatable workflows without manual setup each time.
</td>
<td style="vertical-align: top; border: none;">
<strong>🌳 Workspace Control</strong><br>
Full CRUD for spaces, folders, lists, webhooks, and tags across the entire workspace hierarchy. Manage access control (ACL) permissions at any level. Switch workspaces mid-conversation without reconfiguration.
</td>
</tr>
</table>

---

<a name="premium-access"></a>💎 Premium Access

<div align="center">

<h3>Unlock 150 Enterprise-Grade Custom Tools</h3>

This project transitioned from open-source to a paid model for sustainable full-time development and priority support.
A license grants full, unrestricted access to all features across your agents⎯no limits.

<br>

| Monthly $9/mo | Annual $59/yr | Lifetime <!--LIFETIME_HEADER-->$119<!--/LIFETIME_HEADER--> |
| :--------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| • Pay-as-you-go flexibility<br>• 3 device activations<br>• Cancel anytime | • Save 45% ($4.92/mo)<br>• 3 device activations<br>• Priority support all year | • Best Value — One payment<br>• 3 device activations<br>• <!--LIFETIME_DETAIL-->Unlocked Forever<!--/LIFETIME_DETAIL--> |

<br>

<p align="center">
&nbsp;&nbsp;<a href="https://buy.polar.sh/polar_cl_tZ2q8jRvtaaduurOkQKKJmRgdD43ZiB5K0GZn0aQcur?utm_source=github&utm_medium=readme"></a>&nbsp;&nbsp;
</p>

<br>

⚡️ Instant Key Delivery (Polar.sh) &nbsp; • &nbsp; Setup takes less than 2 mins &nbsp; &nbsp; &nbsp;

</div>

---

🚀 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

<a name="antigravity-setup"></a>

<details>
<summary>&nbsp; <strong>Antigravity (IDE &amp; 2.0)</strong></summary>

Download from antigravity.google. Covers Antigravity IDE (VS Code-based agentic editor) and Antigravity 2.0 (standalone desktop agent orchestration app). Both share the same configuration file.

Configuration Path: ~/.gemini/config/mcp_config.json

> Tip: Open the Agent Panel → ... → Manage MCP Servers → View raw config to open this file directly. Or type /mcp in the prompt panel.

Option A: Remote / Streamable HTTP (Recommended)

{
  "mcpServers": {
    "ClickUp": {
      "serverUrl": "https://clickup-mcp.taazkareem.com/mcp",
      "headers": { "X-License-Key": "your-license-key" }
    }
  }
}

Option B: Local / STDIO

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

</details>

<a name="antigravity-cli-setup"></a>

<details>
<summary>&nbsp; <strong>Antigravity CLI (agy)</strong></summary>

A lightweight terminal-based interface (TUI) for Antigravity agents. Install with:

curl -fsSL https://antigravity.google/cli/install.sh | bash

Configuration Path: ~/.gemini/antigravity-cli/mcp_config.json

> Tip: Run agy and type /mcp in the interactive session to manage servers from within the TUI.

Option A: Remote / Streamable HTTP (Recommended)

{
  "mcpServers": {
    "ClickUp": {
      "serverUrl": "https://clickup-mcp.taazkareem.com/mcp",
      "headers": { "X-License-Key": "your-license-key" }
    }
  }
}

Option B: Local / STDIO

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

</details>

<a name="hermes-setup"></a>

<details>
<summary>&nbsp; <strong>Hermes Agent</strong></summary>

Single Agent Configuration Path: ~/.hermes/config.yaml

Option A: Remote / Streamable HTTP

hermes mcp add clickup \
  --url https://clickup-mcp.taazkareem.com/mcp \
  --auth oauth && \
hermes config set mcp_servers.clickup.headers.X-License-Key "your-license-key"

Option B: Local / STDIO

hermes mcp add clickup \
  --command npx \
  --args -y @taazkareem/clickup-mcp-server@latest \
  --env CLICKUP_API_KEY="your-api-key" \
        CLICKUP_TEAM_ID="your-team-id" \
        CLICKUP_MCP_LICENSE_KEY="your-license-key"

- Run it: hermes

---

Multi-Agent Setup (Profiles + Personas)

Run a team of specialized agents on the same workspace (or separate). Each Hermes profile is an isolated agent with its own config and SOUL.md instructions. Configure each profile to match a persona (X-Persona) as needed. This will scope which ClickUp tools is in its context. Guide with examples:

1. Create the profiles

hermes profile create project_manager
hermes profile create task_worker
hermes profile create auditor

> Optional: Use --clone to copy the existing config.yaml/.env/SOUL.md, or re-run the commands from above.

2. Set each profile's persona. The profile has the MCP config now, so just add the matching persona:

project_manager config set mcp_servers.clickup.headers.X-Persona "project_manager"
task_worker     config set mcp_servers.clickup.headers.X-Persona "task_worker"
auditor         config set mcp_servers.clickup.headers.X-Persona "auditor"

3. Give each agent its instructions in ~/.hermes/profiles/<name>/SOUL.md (auditor shown):

# ClickUp Auditor
You are a read-only project auditor. Observe and report — never change anything.

- Summarize task status, overdue items, and blockers concisely.

- Surface risks and recommend actions, but never execute them.

- If asked to create or modify a task, decline and explain you are read-only.

Run any agent query by its profile (call by User or Agent):

project_manager chat -q "Break the Q3 launch into a list with subtasks and owners"
auditor         chat -q "Audit the Sprint board and report what's at risk"

Run a TUI or Gateway called by User:

project_manager gateway start
auditor         chat

---

Other (Custom Agents, etc.)
For most other MCP-compliant hosts:

- Server URL: https://clickup-mcp.taazkareem.com/mcp
- Auth Header: X-License-Key: your-license-key

</details>

<a name="openclaw-setup"></a>

<details>
<summary>&nbsp; <strong>OpenClaw (via mcporter) </strong></summary>

1. Enable mcporter in ~/.openclaw/openclaw.json:

{ "skills": { "allowBundled": ["mcporter"] } }

2. Configure & Auth

# Add ClickUp as a remote server
mcporter config add ClickUp https://clickup-mcp.taazkareem.com/mcp --auth oauth --header "X-License-Key=your-license-key"
Authenticate session
mcporter auth ClickUp

> Pro Tip: Use Personas to define multiple isolated configurations (e.g., Auditor vs. Worker) in your agent's mcporter.json.

</details>

<a name="cursor-setup"></a>

<details>
<summary>&nbsp; <strong>Cursor</strong></summary>

Configuration Path: <project-root>/.cursor/mcp.json

Option A: Remote / Streamable HTTP (Easiest)

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

Option B: Local / STDIO

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

</details>

<a name="vscode-setup"></a>

<details>
<summary>&nbsp; <strong>VS Code</strong></summary>

Configuration Paths:

- Global: ~/Library/Application Support/Code/User/mcp.json
- Local: <project-root>/.vscode/mcp.json

Option A: Remote / Streamable HTTP (Easiest)

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

Option B: Local / STDIO

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

</details>

<a name="roocode-setup"></a>

<details>
<summary>&nbsp; <strong>Roo Code</strong></summary>

Configuration Path: <project-root>/.roo/mcp.json

Option A: Remote / Streamable HTTP (Easiest)

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

Option B: Local / STDIO

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

</details>

<a name="claude-desktop-setup"></a>

<details>
<summary>&nbsp; <strong>Claude Desktop</strong></summary>

Configuration Path: ~/Library/Application Support/Claude/claude_desktop_config.json

Remote Setup (Requires mcp-remote adapter):

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://clickup-mcp.taazkareem.com/mcp",
        "--header",
        "X-License-Key: your-license-key"
      ]
    }
  }
}

</details>

<a name="claude-code-setup"></a>

<details>
<summary>&nbsp; <strong>Claude Code (CLI)</strong></summary>

Run this command in your terminal:

claude mcp add --transport http ClickUp https://clickup-mcp.taazkareem.com/mcp \
  --header "X-License-Key: your-license-key"

</details>

<a name="n8n-setup"></a>

<details>
<summary>&nbsp; <strong>n8n</strong></summary>

Option A: Remote / Streamable HTTP (Recommended)

1. In n8n, add an "MCP Client" node.
2. Set Connection Type to Streamable HTTP.
3. Auth Type: Multiple Headers Auth.
4. Header: X-License-Key Value: your-license-key
5. URL: https://clickup-mcp.taazkareem.com/mcp

Option B: Self-Hosted Docker
Run the container:

docker run -d -p 3231:3231 ghcr.io/taazkareem/clickup-mcp-server:latest

In n8n, use URL: http://host.docker.internal:3231/mcp

</details>

<a name="codex-setup"></a>

<details>
<summary>&nbsp; <strong>Codex (CLI, Desktop, IDE)</strong></summary>

Codex clients (CLI, Desktop App, and VS Code extension) share a single source of truth for configuration.

Configuration Paths:

- Global: ~/.codex/config.toml
- Local: <project-root>/.codex/config.toml

Option A: Remote / Streamable HTTP (Easiest)

[mcp_servers.ClickUp]
url = "https://clickup-mcp.taazkareem.com/mcp"
http_headers = { "X-License-Key" = "your-license-key" }

Option B: Local / STDIO

[mcp_servers.ClickUp]
command = "npx"
args = ["-y", "@taazkareem/clickup-mcp-server@latest"]
env = {
  CLICKUP_API_KEY = "your-api-key",
  CLICKUP_TEAM_ID = "your-team-id",
  CLICKUP_MCP_LICENSE_KEY = "your-license-key"
}

Quick Tips:

- Codex CLI: Run codex mcp list to verify. Use codex mcp add ... as a CLI alternative to editing the file.
- VS Code Extension: Click ⚙ → MCP settings → Open config.toml.
- Desktop App: Go to Settings → Integrations & MCP.
</details>

<a name="chatgpt-setup"></a>

<details>
<summary>&nbsp; <strong>ChatGPT (Developer Mode)</strong></summary>

_Note: Requires a Business, Enterprise, or Edu workspace with Developer Mode enabled._

1. Enable Developer Mode: Ask your workspace admin to enable this under Workspace Settings → Permissions & Roles → Connected Data.
2. Connect MCP: Go to Settings → Connectors and toggle Developer Mode on.
3. Add Custom Connector:
- Click Add connector (or "Create custom connector").
- Choose MCP as the source type.
4. Configure:
- Server URL: https://clickup-mcp.taazkareem.com/mcp
- Authentication: Add HTTP header X-License-Key: your-license-key.
5. Use: Start a Developer Mode chat and select your ClickUp connector via Add sources.
</details>

<a name="augment-setup"></a>

<details>
<summary>&nbsp; <strong>Augment Code</strong></summary>

Configuration Path: <project-root>/.augment/settings.json

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

</details>

<a name="auggierun-setup"></a>

<details>
<summary>&nbsp; <strong>Auggie CLI</strong></summary>

Run this command in your terminal:

auggie mcp add ClickUp --url https://clickup-mcp.taazkareem.com/mcp \
  --header "X-License-Key: your-license-key"

</details>

<a name="windsurf-setup"></a>

<details>
<summary>&nbsp; <strong>Windsurf</strong></summary>

Configuration Path: <project-root>/.codeium/windsurf/mcp_config.json

Option A: Remote / Streamable HTTP (Easiest)

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

Option B: Local / STDIO

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

</details>

3. Restart

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

---

<a name="available-tools"></a>🛠️ Available Tools

<details>
<summary><strong>👇 Click to view all 150 available tools</strong></summary>

| Category | Tool | Description |
| :----------------- | :---------------------------- | :------------------------------------------------------------------------------------------------------ |
| Workspace | get_workspace | Get workspace structure and metadata (hierarchy, members, plan, seats, shared items, custom task types) |
| | get_workspace_seats | Get member and guest seat utilization (used, total, available) |
| | get_workspace_plan | Get plan details for the workspace (plan_name, plan_id) |
| | get_audit_logs | Retrieve workspace audit logs (Enterprise only) |
| Tasks | create_task | Create a task |
| | get_task | Get single task details |
| | update_task | Modify task properties |
| | move_task | Move task to new list |
| | duplicate_task | Copy task |
| | delete_task | Remove task |
| | add_task_to_list | Associate task with additional list (TIML) |
| | remove_task_from_list | Remove task list association (TIML) |
| | create_bulk_tasks | Create multiple tasks |
| | update_bulk_tasks | Update multiple tasks |
| | move_bulk_tasks | Move multiple tasks |
| | delete_bulk_tasks | Delete multiple tasks |
| | get_workspace_tasks | Search tasks with Deep Search filtering |
| | get_comments | Get comments on a task, list, or view |
| | create_comment | Create a comment on a task, list, or view |
| | update_comment | Edit or resolve a comment |
| | delete_comment | Delete a comment |
| | get_comment_replies | Get threaded replies for a comment |
| | create_comment_reply | Reply to a comment in a thread |
| | add_comment_reaction | Add an emoji reaction to a comment |
| | remove_comment_reaction | Remove an emoji reaction from a comment |
| | get_comment_subtypes | Get post subtype IDs for the workspace |
| | add_task_link | Link two tasks together |
| | get_task_links | Get task links |
| | delete_task_link | Remove a t