ClickUp MCP Server - Premium

Properly Connect ClickUp to AI Agents including Claude Desktop, Antigravity, Gemini CLI, Claude Code, Codex, OpenCode, n8n, OpenClaw, Roo Code, Windsurf, Cursor IDE, and more.

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

Status Update: v0.12.10: New improvements including full @mention support for chat messages and comments, and full markdown support in chat messages, automatic rich text conversion for comments. Fixed Anthropic API Schema Compatibility (Issue #5).

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

---

🔥 Features

• 🔐 Hybrid Authentication : MCP spec compliant OAuth 2.1 with advanced security hardening, backwards compatible with ClickUp API Key and Team ID for env variables/headers. (Remote version only)
• 📝 Task Management: Create, update, move, delete, duplicate, and link tasks. Supports bulk operations, natural language dates, full markdown, @mentions, and file attachments.
• 🔍 Intelligent Search: Find tasks workspace-wide with fuzzy matching across names, statuses, tags, custom fields, and descriptions. Automatic name resolution—just say the task name, no IDs needed.
• ⏱️ Time Tracking: Start/stop timers in natural language, view entries, and manage billable time.
• 📄 Manage Documents: Create, read, and append to ClickUp Documents in the correct location. Supports full markdown.
• 💬 Chat & Collaboration: Send and retrieve messages in chat channels and task comments with automatic rich-text conversion and @mention support.
• 🌳 Workspace Control: Create, navigate, and manage spaces, folders, lists, and tags. With OAuth login, select multiple Workspaces and switch between them mid-conversation.
• 🧠 Smart Defaults: Fuzzy matching for statuses (todo ↔ to-do), members, spaces, folders, and lists. Session-isolated caching for fast, secure multi-tenant operation.

---

🛠️ Available Tools

👇 Click to view all 50+ available tools

Category	Tool	Description
Workspace	get_workspace_hierarchy	Get workspace structure
	get_workspace_members	Get all workspace members
	find_member_by_name	Find member by name or email
	resolve_assignees	Resolve names/emails to user IDs
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
	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 filtering
	get_task_comments	Get comments on a task
	create_task_comment	Add a comment to a task
	attach_task_file	Attach file to a task
	add_task_link	Link two tasks together
	get_task_links	Get task dependencies
	delete_task_link	Remove task dependency
Lists	create_list	Create list in space
	create_list_in_folder	Create list in folder
	get_list	Get list details
	update_list	Update list properties
	delete_list	Delete a list
Folders	create_folder	Create folder
	get_folder	Get folder details
	update_folder	Update folder properties
	delete_folder	Delete a folder
Tags	get_space_tags	Get space tags
	create_space_tag	Create tag
	update_space_tag	Update tag properties
	delete_space_tag	Delete a tag
	add_tag_to_task	Add tag to task
	remove_tag_from_task	Remove tag from task
Time Tracking	get_task_time_entries	Get time entries for a task
	start_time_tracking	Start time tracking
	stop_time_tracking	Stop current time tracking
	add_time_entry	Add manual time entry
	delete_time_entry	Delete time entry
	get_current_time_entry	Get running timer
Docs	create_document	Create a document
	get_document	Get a document
	list_documents	List documents
	list_document_pages	List pages in a document
	get_document_pages	Get page content
	create_document_page	Add page to document
	update_document_page	Update page content
Chat	create_chat_channel	Create a chat channel
	get_chat_channels	List chat channels
	create_chat_message	Send a message to a channel
	get_chat_messages	Get message history
Feedback	submit_feedback	Submit feedback or bug reports

See full documentation for parameters and advanced usage.

---

💎 Premium Access

This project operates on a Sponsorware model. This high-performance MCP server is maintained daily to ensure compatibility with the latest AI agents and ClickUp API changes. A license grants full access to all 50+ tools, priority bug fixes, and enterprise-grade feature development.

Monthly Subscription ($9)	Lifetime Access ($59)
• Perfect for ongoing projects • Cancel anytime	• One-time payment • Best value for agencies

⚡️ Instant Delivery: Your license key is delivered immediately via Polar.sh. Total setup time is under 2 minutes.

---

---

🚀 Quick Start

1. Prerequisites

• Node.js v18.0.0+
• ClickUp Credentials: API Key & Team ID
• License Key: Purchase here

2. Local Configuration

Add the following to your claude_desktop_config.json or similar MCP settings file to run locally via npx:

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

3. Hosted / Remote Usage

-or- For zero-setup usage without local Node.js requirements, use the hosted version:

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

4. Restart

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

---

⚙️ 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.

Advanced Configuration

Filter Available Tools

💡 Pro Tip! Reduce context noise by limiting available tools in your env arguments:

"ENABLED_TOOLS": "get_workspace_hierarchy,create_task,get_task,update_task"

-or- the hosted version headers:

"X-Enabled-Tools": "find_member_by_name, create_chat_channel, create_chat_message, get_chat_messages, submit_feedback"

Enable Document Support (Beta)

Enable creation and management of ClickUp Docs:

"DOCUMENT_SUPPORT": "true"

---

🔌 Compatibility

This server supports STDIO, HTTP Streamable, and SSE (Server-Sent Events) for legacy integrations.

n8n Setup - Remote Server (Recommended):

1. In n8n, add an "MCP Client" node.
2. Set Connection Type to HTTP Streamable.
3. Select Authentication Type Multiple Headers Auth and rename it to ClickUp.
4. Add custom headers:
   • X-ClickUp-Key: <your ClickUp API key>
   • X-ClickUp-Team-Id: <your Team ID>
   • X-License-Key: <your license key>
5. Set URL to https://clickup-mcp.taazkareem.com/mcp

n8n Docker Setup (Alternative):

Run the server with Docker:

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

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

---

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

_{Created by taazkareem}