ClickUp MCP Server - Premium

ClickUp MCP Server Premium Image

Properly Connect ClickUp to AI Agents and Agentic Workflows

A high-performance Model Context Protocol (MCP) server for managing tasks, comments, tags, 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	Cursor Windsurf VS Code Roo Code Claude Claude Code n8n Gemini CLI Antigravity Codex ChatGPT Augment Auggie OpenClaw Other ➕ Add Agent

✨ Features

💎 Premium Access

This project operates on a Sponsorware model. A license grants full access to all 58+ premium tools with any of the following plans:

Monthly Plan ($9/mo)	Annual Subscription ($59/yr)	Lifetime Access ($89 w/ code)
• Pay-as-you-go flexibility• 3 device activations• Cancel anytime	• ONLY $4.92/mo • 3 device activations• Priority bug fixes	• 25% OFF code: `FEB25` • 3 device activations• Best Value (One-time payment)

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

🚀 Quick Start & Installation

1. Prerequisites

License Key: See above
ClickUp Credentials: (Optional) API Key & Team ID

ClickUp API Key:
1. Log into ClickUp and go to ClickUp Settings → Apps.
2. Click Generate under "API Token" (or copy your existing one).
ClickUp Team ID:
1. Open ClickUp in your browser.
2. Look at the URL: https://app.clickup.com/1234567/v/li/987654321.
3. The first number (1234567) directly after clickup.com/ is your Team ID (Workspace ID).

2. Choose your Integration

Configuration Path: <project-root>/.cursor/mcp.json

Option A: Cloud / Remote (Easiest)

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

Option B: Local (stdio)

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

Configuration Path: <project-root>/.codeium/windsurf/mcp_config.json

Option A: Cloud / Remote (Easiest)

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

Option B: Local (stdio)

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

Configuration Paths:

Global: ~/Library/Application Support/Code/User/mcp.json
Local: <project-root>/.vscode/mcp.json

Option A: Cloud / Remote (Easiest)

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

Option B: Local (stdio)

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

Configuration Path: <project-root>/.roo/mcp.json

Option A: Cloud / Remote (Easiest)

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

Option B: Local (stdio)

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

Configuration Path: ~/Library/Application Support/Claude/claude_desktop_config.json

Remote Setup (Requires mcp-remote adapter):

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://clickup-mcp.taazkareem.com/mcp",
        "--header", "X-License-Key: your-license-key"
      ]
    }
  }
}

Run this command in your terminal:

claude mcp add --transport http ClickUp https://clickup-mcp.taazkareem.com/mcp \
  --header "X-License-Key: your-license-key"

Option A: Cloud / Remote (Recommended)

In n8n, add an "MCP Client" node.
Set Connection Type to HTTP Streamable.
Auth Type: Multiple Headers Auth.
Header: X-License-Key Value: your-license-key
URL: https://clickup-mcp.taazkareem.com/mcp

Option B: Self-Hosted Docker Run the container:

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

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

Configuration Path: ~/.gemini/settings.json

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

Configuration Path: ~/.gemini/antigravity/mcp_config.json

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

Codex clients (CLI, Desktop App, and VS Code extension) share a single source of truth for configuration.

Configuration Paths:

Global: ~/.codex/config.toml
Per-Project: <project-root>/.codex/config.toml

Option A: Cloud / Remote (Easiest)

[mcp_servers.ClickUp]
url = "https://clickup-mcp.taazkareem.com/mcp"
http_headers = { "X-License-Key" = "your-license-key" }

Option B: Local (stdio)

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

Quick Tips:

Codex CLI: Run codex mcp list to verify. Use codex mcp add ... as a CLI alternative to editing the file.
VS Code Extension: Click ⚙ → MCP settings → Open config.toml.
Desktop App: Go to Settings → Integrations & MCP.

Note: Requires a Business, Enterprise, or Edu workspace with Developer Mode enabled.

Enable Developer Mode: Ask your workspace admin to enable this under Workspace Settings → Permissions & Roles → Connected Data.
Connect MCP: Go to Settings → Connectors and toggle Developer Mode on.
Add Custom Connector:
- Click Add connector (or "Create custom connector").
- Choose MCP as the source type.
Configure:
- Server URL: https://clickup-mcp.taazkareem.com/mcp
- Authentication: Add HTTP header X-License-Key: your-license-key.
Use: Start a Developer Mode chat and select your ClickUp connector via Add sources.

Configuration Path: <project-root>/.augment/settings.json

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

Run this command in your terminal:

auggie mcp add ClickUp --url https://clickup-mcp.taazkareem.com/mcp \
  --header "X-License-Key: your-license-key"

1. Enable the mcporter skill in ~/.openclaw/openclaw.json:

{"skills": {"allowBundled": ["mcporter"]}}

2. Configure — add to ~/.mcporter/mcporter.json:

{
  "mcpServers": {
    "ClickUp": {
      "baseUrl": "https://clickup-mcp.taazkareem.com/mcp",
      "auth": "oauth",
      "headers": {
        "X-License-Key": "your-license-key"
      }
    }
  }
}

3. Authenticate — run once to authorize via browser (tokens are cached):

mcporter auth ClickUp

4. Use:

mcporter call ClickUp.get_workspace_hierarchy team_id=0123456789

Tip: Since mcporter is a one-shot CLI client, if using multiple workspaces, always pass team_id to target the correct workspace.

For most MCP-compliant hosts (e.g. Smithery, MCP Inspector, custom GUIs):

Server URL: https://clickup-mcp.taazkareem.com/mcp
Auth Header: X-License-Key: your-license-key (Required for HTTP/SSE connections)

Advanced: OpenAI Agents SDK For developers building custom agents.

Python SDK:

from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    name="clickup",
    params={
        "url": "https://clickup-mcp.taazkareem.com/mcp",
        "headers": {"X-License-Key": "your-license-key"},
    },
) as server:
    agent = Agent(
        name="Assistant",
        instructions="Use the ClickUp MCP tools when helpful.",
        mcp_servers=[server],
    )
    result = await Runner.run(agent, "List my workspaces.")

3. Restart

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

🛠️ 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
	`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
	`add_task_to_list`	Associate task with additional list (TIML)
	`remove_task_from_list`	Remove task list association (TIML)
	`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
	`move_list`	Move list to new Space/Folder
	`delete_list`	Delete a list
Folders	`create_folder`	Create folder
	`get_folder`	Get folder details
	`update_folder`	Update folder properties
	`move_folder`	Move folder to new Space
	`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 with date filters
	`get_workspace_time_entries`	Search all time entries
	`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.

⚙️ Advanced Configuration

Filter Available Tools

💡 Pro Tip! Reduce context noise for the AI by limiting available tools.

Local (Environment Variable):

"ENABLED_TOOLS": "tool_1,tool_2,tool_3"

-or- Remote (Header):

"X-Enabled-Tools": "tool_1,tool_2,tool_3"

Preset Configurations

Here are copy-pasteable recommended configurations for common agent personas. You can use these in your mcp.json (env) or via HTTP headers. Customization is easy - just add or remove tools you don't need.

Best for agents that need to view data without making any changes.

HTTP Header: X-Enabled-Tools: get_workspace_hierarchy,get_workspace_tasks,get_task,get_list,get_folder,get_task_comments,get_task_time_entries,get_workspace_time_entries,get_current_time_entry,get_task_links,get_space_tags,get_workspace_members,find_member_by_name,get_chat_channels,get_chat_messages,get_document,list_documents,list_document_pages,get_document_pages,submit_feedback

JSON / Env:

"env": {
  "ENABLED_TOOLS": "get_workspace_hierarchy,get_workspace_tasks,get_task,get_list,get_folder,get_task_comments,get_task_time_entries,get_workspace_time_entries,get_current_time_entry,get_task_links,get_space_tags,get_workspace_members,find_member_by_name,get_chat_channels,get_chat_messages,get_document,list_documents,list_document_pages,get_document_pages,submit_feedback"
}

Focused on day-to-day task management. Can create/update tasks and track time, but cannot delete tasks or modify structure (Lists/Folders).

HTTP Header: X-Enabled-Tools: get_workspace_hierarchy,get_workspace_tasks,get_task,create_task,update_task,move_task,duplicate_task,create_task_comment,get_task_comments,attach_task_file,start_time_tracking,stop_time_tracking,add_tag_to_task,remove_tag_from_task,add_task_link,delete_task_link,get_task_links,add_task_to_list,remove_task_from_list,find_member_by_name,submit_feedback

JSON / Env:

"env": {
  "ENABLED_TOOLS": "get_workspace_hierarchy,get_workspace_tasks,get_task,create_task,update_task,move_task,duplicate_task,create_task_comment,get_task_comments,attach_task_file,start_time_tracking,stop_time_tracking,add_tag_to_task,remove_tag_from_task,add_task_link,delete_task_link,get_task_links,add_task_to_list,remove_task_from_list,find_member_by_name,submit_feedback"
}

For agents dedicated to logging time and generating timesheets.

HTTP Header: X-Enabled-Tools: get_workspace_hierarchy,get_workspace_tasks,get_task,get_task_time_entries,get_workspace_time_entries,get_current_time_entry,start_time_tracking,stop_time_tracking,add_time_entry,delete_time_entry,submit_feedback

JSON / Env:

"env": {
  "ENABLED_TOOLS": "get_workspace_hierarchy,get_workspace_tasks,get_task,get_task_time_entries,get_workspace_time_entries,get_current_time_entry,start_time_tracking,stop_time_tracking,add_time_entry,delete_time_entry,submit_feedback"
}

For agents managing documentation and communication.

HTTP Header: X-Enabled-Tools: get_workspace_hierarchy,get_workspace_tasks,create_document,get_document,list_documents,list_document_pages,get_document_pages,create_document_page,update_document_page,create_chat_channel,get_chat_channels,create_chat_message,get_chat_messages,submit_feedback

JSON / Env:

"env": {
  "ENABLED_TOOLS": "get_workspace_hierarchy,get_workspace_tasks,create_document,get_document,list_documents,list_document_pages,get_document_pages,create_document_page,update_document_page,create_chat_channel,get_chat_channels,create_chat_message,get_chat_messages,submit_feedback"
}

Enabled everything except destructive tools. This configuration covers all 58 tools by default, only blocking the 7 specific deletion tools listed below. Useful for capable agents that need full access (including Folder/List management) but shouldn't destroy data.

HTTP Header: X-Disabled-Tools: delete_task,delete_bulk_tasks,delete_time_entry,delete_task_link,delete_list,delete_folder,delete_space_tag

JSON / Env:

"env": {
  "DISABLED_TOOLS": "delete_task,delete_bulk_tasks,delete_time_entry,delete_task_link,delete_list,delete_folder,delete_space_tag"
}

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

ClickUp MCP

ClickUp MCP Server - Premium

📚 Table of Contents

✨ Features

💎 Premium Access

🚀 Quick Start & Installation

1. Prerequisites

2. Choose your Integration

3. Restart

🛠️ Available Tools

⚙️ Advanced Configuration

Filter Available Tools

Preset Configurations

❓ FAQ

⚖️ Disclaimer

Related Servers

Google Sheets

Apple Shortcuts

TimeMCP

MCP Orchestro

Google Calendar

paperbanana

Linear MCP Server

Learning-Assistant-MCP

early-mcp

StashDog MCP Server