Clickup Mcp Server by taazkareem - MCP Server

ClickUp MCP Server

ClickUp MCP Server Premium Image

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.

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

🚀 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 team_id, but it actually represents your Workspace ID.

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

👇 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
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 for parameters and advanced usage.

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

_{Created by taazkareem}
_{This project is an independent work and is not officially associated with or sponsored by ClickUp.}

taazkareem/clickup-mcp-server