clickup-mcp-server

<h1 align="center">ClickUp MCP Server — Premium</h1> <p align="center"> <img src="https://raw.githubusercontent.com/taazkareem/clickup-mcp-server/main/assets/images/clickup_mcp_neon_logo_blue.jpg" alt="ClickUp MCP Server Premium Logo" width="100%"> </p> <p align="center"> <a href="https://www.npmjs.com/package/@taazkareem/clickup-mcp-server"><img src="https://img.shields.io/npm/v/@taazkareem/clickup-mcp-server.svg" alt="npm version"></a> <a href="https://www.npmjs.com/package/@taazkareem/clickup-mcp-server"><img src="https://img.shields.io/npm/dm/@taazkareem/clickup-mcp-server.svg" alt="npm downloads"></a> <img src="https://img.shields.io/badge/License-Proprietary-red.svg" alt="License"> <img src="https://img.shields.io/badge/Ranked_Top_3_on_Google-🔥-orange.svg" alt="Top 3 on Google"> <img src="https://img.shields.io/badge/Trending-MCP_Server-blueviolet.svg" alt="Trending MCP Server"> <a href="https://github.com/TaazKareem/clickup-mcp-server/graphs/commit-activity"><img src="https://img.shields.io/badge/Maintained%3F-yes-blue.svg" alt="Maintained"></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 | | :--- | :--- | | • Features<br>• Premium Access<br>• Available Tools<br>• Adv. Config<br>• FAQ<br>• 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;"><img src="./assets/logos/antigravity.svg" height="16" style="vertical-align: middle;"> Antigravity</td> <td width="155" style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/antigravity.svg" height="16" style="vertical-align: middle;"> Agy CLI</td> <td width="140" style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/images/hermes-logo.png" height="16" style="vertical-align: middle;"> Hermes</td> <td width="140" style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/openclaw-logo.svg" height="16" style="vertical-align: middle;"> OpenClaw</td> </tr> <tr style="border: none;"> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/cursor-white.svg" height="16" style="vertical-align: middle;"> Cursor</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/visual-studio-code.svg" height="16" style="vertical-align: middle;"> VS Code</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/claude.svg" height="16" style="vertical-align: middle;"> Claude</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="https://cdn.simpleicons.org/anthropic/D97757" height="16" style="vertical-align: middle;"> ClaudeCode</td> </tr> <tr style="border: none;"> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="https://cdn.simpleicons.org/n8n/FF6D5A" height="16" style="vertical-align: middle;"> n8n</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/openai-icon.svg" height="16" style="vertical-align: middle;"> Codex</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/openai-icon.svg" height="16" style="vertical-align: middle;"> ChatGPT</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/augment-code.svg" height="16" style="vertical-align: middle;"> Augment</td> </tr> <tr style="border: none;"> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/augment-code.svg" height="16" style="vertical-align: middle;"> Auggie</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/windsurf-white.svg" height="16" style="vertical-align: middle;"> Windsurf</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="https://avatars.githubusercontent.com/u/211522643?s=200&v=4" height="16" style="vertical-align: middle; border-radius: 4px;"> Roo 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-->$89 w/ code<!--/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-->25% OFF code: AUG25<!--/LIFETIME_DETAIL--> |

<br> <p align="center"> <img src="./assets/images/line.svg" width="150" alt="" style="vertical-align: middle;">&nbsp;&nbsp;<a href="https://buy.polar.sh/polar_cl_tZ2q8jRvtaaduurOkQKKJmRgdD43ZiB5K0GZn0aQcur?utm_source=github&utm_medium=readme"><img src="https://img.shields.io/badge/PURCHASE%20LICENSE-0069ff?style=for-the-badge&logo=polar&logoColor=white" alt="Purchase License" style="vertical-align: middle;"></a>&nbsp;&nbsp;<img src="./assets/images/line.svg" width="150" alt="" style="vertical-align: middle;"> </p> <br>

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

</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> <sum