What can you do with this server?

The ClickUp MCP Server enables AI applications to comprehensively interact with ClickUp workspaces for task, time, document, and workspace management. * Task Management: Create, update, delete, move, and duplicate tasks individually or in bulk. * Time Tracking: Start/stop tracking, add manual entries, and manage time entries for tasks. * Document Management: Create, update, list, and manage documents and their pages. * Workspace Organization: Navigate and manage the complete hierarchy of spaces, folders, and lists. * Tag Management: Create, update, delete, and assign tags to tasks. * Comments & Attachments: Manage task comments and attachments. * Integration Features: Supports global lookups by name or ID, case-insensitive matching, markdown formatting, and comprehensive API coverage. * Error Handling: Provides clear error messages for various scenarios.

Which integrations are available for this server?

Allows AI agents to interact with ClickUp tasks, spaces, lists, and folders, including creating, updating, deleting, moving and duplicating tasks, as well as managing workspace organization through a standardized Model Context Protocol (MCP) server.

How do I use ClickUp MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ClickUp MCP Server show me my overdue tasks" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

ClickUp MCP Server

ClickUp MCP Server Premium Image

npm version npm downloads License Maintained

Connect ClickUp to AI Agents including Claude Desktop, Cursor IDE, n8n, and Gemini CLI. A high-performance Model Context Protocol (MCP) server for managing tasks, tags, lists, folders, files, docs, time, and chat using natural language.

Status Update: Latest (v0.12.4) update fixes Markdown Description support for the get_task tool to intelligently improve High-Fidelity Context.

⭐️ 460+ Stars (from previous public repo) - Industry-Standard ClickUp MCP Integration

💎 Premium Access

This project operates on a Sponsorware model. To ensure dedicated maintenance, rapid API updates, and priority support, the source code and latest builds are exclusively available to supporters.

Monthly Subscription ($9)

Lifetime Access ($59)

• Perfect for ongoing projects

• Cancel anytime

• Pay once, use forever

• Best value for agencies

Instant Access: Licenses are delivered immediately via Polar.sh. Setup takes < 2 minutes.

Related MCP server: ClickUp MCP Server

🚀 Quick Start

1. Prerequisites

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

2. Configure MCP Client

Add the following to your claude_desktop_config.json or similar MCP settings file:

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

3. Restart

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

✨ Features

Integrate ClickUp seamlessly with Natural Language for customized workflows

📝 Task Management: Create, update, move, duplicate, and link tasks. Supports bulk operations and natural language dates.
⏱️ Time Tracking: Start/stop timers, view entries, and manage billable time.
📄 Docs & Knowledge: Create, read, and append to ClickUp Documents. Full workspace hierarchy traversal.
💬 Chat & Collaboration: Send messages to channels, read history, and manage comments with Markdown support.
🌳 Workspace Control: Navigate spaces, folders, and lists. Manage tags and member assignments.

⚙️ Configuration

Finding Your Credentials

ClickUp API Key:
- Navigate to ClickUp Settings → Apps.
- Generate a token under "API Token".
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

Tool Filtering (Optional)

Reduce context noise by limiting available tools. Add this to your env configuration:

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

🛠️ 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
Tasks	`create_task`	Create a task
	`create_bulk_tasks`	Create multiple tasks
	`update_task`	Modify task
	`update_bulk_tasks`	Update multiple tasks
	`get_tasks`	Get tasks from list
	`get_task`	Get single task details
	`get_workspace_tasks`	Get tasks with filtering
	`delete_task`	Remove task
	`move_task`	Move task to new list
	`duplicate_task`	Copy task
	`add_task_link`	Link two tasks together
Comments	`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
Lists/Folders	`create_list`	Create list in space/folder
	`create_folder`	Create folder
	`get_folder`	Get folder details
	`update_folder`	Update folder properties
Tags	`get_space_tags`	Get space tags
	`create_space_tag`	Create tag
	`add_tag_to_task`	Add tag to task
Time	`start_time_tracking`	Start time tracking
	`stop_time_tracking`	Stop current time tracking
	`get_task_time_entries`	Get time entries for a task
Docs	`create_document`	Create a document
	`get_document`	Get a document
	`list_documents`	List documents
Chat	`create_chat_channel`	Create a chat channel
	`create_chat_message`	Send a message to a channel
	`get_chat_messages`	Get message history

See

🔌 Compatibility

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

Configuration:

{ "env": { "ENABLE_SSE": "true", "PORT": "3231" } }

n8n Setup:

Set ENABLE_SSE to "true" and run the server.
In n8n, add an "MCP AI Tool" node.
Set Transport to SSE and URL to http://localhost:3231/sse.

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