taazkareem/clickup-mcp-server

---
**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 • Premium Access • Available Tools • Adv. Config • FAQ • Disclaimer | Antigravity Agy CLI Hermes OpenClaw Cursor VS Code Claude ClaudeCode n8n Codex ChatGPT Augment Auggie Windsurf Roo Code ➕ Add Agent |
---
✨ Features
**🔥 Multi-Account Support:** Manage multiple authorized workspaces seamlessly in a single session. See setup
🔐 Hybrid Authentication
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).
🔍 Intelligent Search & Resolution
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.
📝 Task Management
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).
⏱️ Time Tracking
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.
📄 Document Management
Create, read, and append to ClickUp Docs with full markdown text. Manage pages within documents for structured, long-form content (consolidated action-based tool).
💬 Comments & Chat
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.
🎯 Goals & Key Results
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.
📋 Views
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.
🗂️ Task Templates
Browse available task templates and instantly create tasks from them. Streamlines repeatable workflows without manual setup each time.
🌳 Workspace Control
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.
---
💎 Premium Access
Unlock 150 Enterprise-Grade Custom Tools
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.
| **Monthly** $9/mo | **Annual** $59/yr | **Lifetime** $89 w/ code |
| :--------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| • Pay-as-you-go flexibility • 3 device activations • Cancel anytime | • **Save 45%** ($4.92/mo) • 3 device activations • Priority support all year | • **Best Value** — One payment • 3 device activations • **25% OFF** code: OCT25 |
     
**⚡️ Instant Key Delivery (Polar.sh)**   •   **Setup takes less than 2 mins**      
---
🚀 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).