Track MCP LogoTrack MCP
Track MCP LogoTrack MCP

The world's largest repository of Model Context Protocol servers. Discover, explore, and submit MCP tools.

Product

  • Categories
  • Top MCP
  • New & Updated
  • Submit MCP

Company

  • About

Legal

  • Privacy Policy
  • Terms of Service
  • Cookie Policy

© 2026 TrackMCP. All rights reserved.

Built with ❤️ by Krishna Goyal

    Clickup Mcp Server

    Integrate ClickUp project management with AI through Model Context Protocol TypeScript-based implementation.

    431 stars
    TypeScript
    Updated Oct 18, 2025
    ai
    artificial-intelligence
    clickup
    clickup-api
    lists
    llm
    mcp
    mcp-server
    model-context-protocol
    productivity
    project-management
    spaces
    task-management
    tasks
    workspaces

    Table of Contents

    • 📚 Table of Contents
    • <a name="features"></a>✨ Features
    • <a name="premium-access"></a>💎 Premium Access
    • 🚀 Quick Start
    • 1. Prerequisites
    • 2. Choose your MCP Host & Transport
    • Multi-Agent Setup (Profiles + Personas)
    • 3. Restart
    • <a name="available-tools"></a>🛠️ Available Tools
    • <a name="advanced-configuration"></a>⚙️ Advanced Configuration
    • Filter Available Tools
    • Preset Configurations
    • <a name="multi-workspace-support"></a>🌍 Multi-Workspace Support
    • <a name="faq"></a>❓ FAQ
    • <a name="disclaimer"></a>⚖️ Disclaimer

    Table of Contents

    • 📚 Table of Contents
    • <a name="features"></a>✨ Features
    • <a name="premium-access"></a>💎 Premium Access
    • 🚀 Quick Start
    • 1. Prerequisites
    • 2. Choose your MCP Host & Transport
    • Multi-Agent Setup (Profiles + Personas)
    • 3. Restart
    • <a name="available-tools"></a>🛠️ Available Tools
    • <a name="advanced-configuration"></a>⚙️ Advanced Configuration
    • Filter Available Tools
    • Preset Configurations
    • <a name="multi-workspace-support"></a>🌍 Multi-Workspace Support
    • <a name="faq"></a>❓ FAQ
    • <a name="disclaimer"></a>⚖️ Disclaimer

    Documentation

    ClickUp MCP Server — Premium

    ---

    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

    LinksQuick Start & Installation
    •&nbsp;Features•&nbsp;Premium&nbsp;Access•&nbsp;Available&nbsp;Tools•&nbsp;Adv.&nbsp;Config•&nbsp;FAQ•&nbsp;Disclaimer Antigravity Agy&nbsp;CLI Hermes OpenClaw Cursor VS&nbsp;Code Claude ClaudeCode n8n Codex ChatGPT Augment Auggie Windsurf Roo&nbsp;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

    ---

    🚀 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).
    • ClickUp Team ID (Optional - not needed for Remote MCP)
    • Open ClickUp in your browser.
    • Look at the URL: https://app.clickup.com/1234567/v/li/987654321.
    • The first number (1234567) directly after clickup.com/ is your Team ID (Workspace ID).

    2. Choose your MCP Host & Transport

    &nbsp; Antigravity (IDE &amp; 2.0)

    Download from antigravity.google. Covers Antigravity IDE (VS Code-based agentic editor) and Antigravity 2.0 (standalone desktop agent orchestration app). Both share the same configuration file.

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

    Tip: Open the Agent Panel → ... → Manage MCP Servers → View raw config to open this file directly. Or type /mcp in the prompt panel.

    Option A: Remote / Streamable HTTP (Recommended)

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

    Option B: Local / STDIO

    json
    {
      "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"
          }
        }
      }
    }

    &nbsp; Antigravity CLI (agy)

    A lightweight terminal-based interface (TUI) for Antigravity agents. Install with:

    bash
    curl -fsSL https://antigravity.google/cli/install.sh | bash

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

    Tip: Run agy and type /mcp in the interactive session to manage servers from within the TUI.

    Option A: Remote / Streamable HTTP (Recommended)

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

    Option B: Local / STDIO

    json
    {
      "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"
          }
        }
      }
    }

    &nbsp; Hermes Agent

    Single Agent Configuration Path: ~/.hermes/config.yaml

    Option A: Remote / Streamable HTTP

    bash
    hermes mcp add clickup \
      --url https://clickup-mcp.taazkareem.com/mcp \
      --auth oauth && \
    hermes config set mcp_servers.clickup.headers.X-License-Key "your-license-key"

    Option B: Local / STDIO

    bash
    hermes mcp add 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"
    • Run it: hermes

    ---

    Multi-Agent Setup (Profiles + Personas)

    Run a team of specialized agents on the same workspace (or separate). Each Hermes profile is an isolated agent with its own config and SOUL.md instructions. Configure each profile to match a persona (X-Persona) as needed. This will scope which ClickUp tools is in its context. Guide with examples:

    1. Create the profiles

    bash
    hermes profile create project_manager
    hermes profile create task_worker
    hermes profile create auditor

    Optional: Use --clone to copy the existing config.yaml/.env/SOUL.md, or re-run the commands from above.

    2. Set each profile's persona. The profile has the MCP config now, so just add the matching persona:

    bash
    project_manager config set mcp_servers.clickup.headers.X-Persona "project_manager"
    task_worker     config set mcp_servers.clickup.headers.X-Persona "task_worker"
    auditor         config set mcp_servers.clickup.headers.X-Persona "auditor"

    See → Advanced Configuration for more customized filtering options.

    3. Give each agent its instructions in ~/.hermes/profiles//SOUL.md (auditor shown):

    markdown
    # ClickUp Auditor
    
    You are a read-only project auditor. Observe and report — never change anything.
    - Summarize task status, overdue items, and blockers concisely.
    - Surface risks and recommend actions, but never execute them.
    - If asked to create or modify a task, decline and explain you are read-only.

    Run any agent query by its profile (call by User or Agent):

    bash
    project_manager chat -q "Break the Q3 launch into a list with subtasks and owners"
    auditor         chat -q "Audit the Sprint board and report what's at risk"

    -OR-

    Run a TUI or Gateway called by User:

    bash
    project_manager gateway start
    auditor         chat

    ---

    Other (Custom Agents, etc.)

    For most other MCP-compliant hosts:

    • Server URL: https://clickup-mcp.taazkareem.com/mcp
    • Auth Header: X-License-Key: your-license-key

    &nbsp; OpenClaw (via mcporter)

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

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

    2. Configure & Auth

    bash
    # Add ClickUp as a remote server
    mcporter config add ClickUp https://clickup-mcp.taazkareem.com/mcp --auth oauth --header "X-License-Key=your-license-key"
    
    # Authenticate session
    mcporter auth ClickUp

    Pro Tip: Use Personas to define multiple isolated configurations (e.g., Auditor vs. Worker) in your agent's mcporter.json.

    &nbsp; Cursor

    Configuration Path: /.cursor/mcp.json

    Option A: Remote / Streamable HTTP (Easiest)

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

    Option B: Local / STDIO

    json
    {
      "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"
          }
        }
      }
    }

    &nbsp; VS Code

    Configuration Paths:

    • Global: ~/Library/Application Support/Code/User/mcp.json
    • Local: /.vscode/mcp.json

    Option A: Remote / Streamable HTTP (Easiest)

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

    Option B: Local / STDIO

    json
    {
      "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"
          }
        }
      }
    }

    &nbsp; Roo Code

    Configuration Path: /.roo/mcp.json

    Option A: Remote / Streamable HTTP (Easiest)

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

    Option B: Local / STDIO

    json
    {
      "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"
          }
        }
      }
    }

    &nbsp; Claude Desktop

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

    **Remote Setup (Requires mcp-remote adapter):**

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

    &nbsp; Claude Code (CLI)

    Run this command in your terminal:

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

    &nbsp; n8n

    Option A: Remote / Streamable HTTP (Recommended)

    1. In n8n, add an "MCP Client" node.

    2. Set Connection Type to Streamable HTTP.

    3. Auth Type: Multiple Headers Auth.

    4. Header: X-License-Key Value: your-license-key

    5. URL: https://clickup-mcp.taazkareem.com/mcp

    Option B: Self-Hosted Docker

    Run the container:

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

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

    &nbsp; Codex (CLI, Desktop, IDE)

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

    Configuration Paths:

    • Global: ~/.codex/config.toml
    • Local: /.codex/config.toml

    Option A: Remote / Streamable HTTP (Easiest)

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

    Option B: Local / STDIO

    toml
    [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.

    &nbsp; ChatGPT (Developer Mode)

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

    1. Enable Developer Mode: Ask your workspace admin to enable this under Workspace Settings → Permissions & Roles → Connected Data.

    2. Connect MCP: Go to Settings → Connectors and toggle Developer Mode on.

    3. Add Custom Connector:

    • Click Add connector (or "Create custom connector").
    • Choose MCP as the source type.

    4. Configure:

    • Server URL: https://clickup-mcp.taazkareem.com/mcp
    • Authentication: Add HTTP header X-License-Key: your-license-key.

    5. Use: Start a Developer Mode chat and select your ClickUp connector via Add sources.

    &nbsp; Augment Code

    Configuration Path: /.augment/settings.json

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

    &nbsp; Auggie CLI

    Run this command in your terminal:

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

    &nbsp; Windsurf

    Configuration Path: /.codeium/windsurf/mcp_config.json

    Option A: Remote / Streamable HTTP (Easiest)

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

    Option B: Local / STDIO

    json
    {
      "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"
          }
        }
      }
    }

    3. Restart

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

    ---

    🛠️ Available Tools

    👇 Click to view all 150 available tools

    CategoryToolDescription
    Workspaceget_workspaceGet workspace structure and metadata (hierarchy, members, plan, seats, shared items, custom task types)
    get_workspace_seatsGet member and guest seat utilization (used, total, available)
    get_workspace_planGet plan details for the workspace (plan_name, plan_id)
    get_audit_logsRetrieve workspace audit logs (Enterprise only)
    Taskscreate_taskCreate a task
    get_taskGet single task details
    update_taskModify task properties
    move_taskMove task to new list
    duplicate_taskCopy task
    delete_taskRemove task
    add_task_to_listAssociate task with additional list (TIML)
    remove_task_from_listRemove task list association (TIML)
    create_bulk_tasksCreate multiple tasks
    update_bulk_tasksUpdate multiple tasks
    move_bulk_tasksMove multiple tasks
    delete_bulk_tasksDelete multiple tasks
    get_workspace_tasksSearch tasks with Deep Search filtering
    get_commentsGet comments on a task, list, or view
    create_commentCreate a comment on a task, list, or view
    update_commentEdit or resolve a comment
    delete_commentDelete a comment
    get_comment_repliesGet threaded replies for a comment
    create_comment_replyReply to a comment in a thread
    add_comment_reactionAdd an emoji reaction to a comment
    remove_comment_reactionRemove an emoji reaction from a comment
    get_comment_subtypesGet post subtype IDs for the workspace
    add_task_linkLink two tasks together
    get_task_linksGet task links
    delete_task_linkRemove a task link
    add_task_dependencySet a blocking dependency between tasks
    delete_task_dependencyRemove a blocking dependency between tasks
    Attachmentslist_attachmentsList attachments for a task or file custom field (v3)
    get_attachmentGet a specific attachment by ID or name (v3)
    upload_attachmentUpload a file to a task or file custom field (v3)
    Checklistscreate_checklistAdd a checklist to a task
    edit_checklistRename or reorder a checklist
    delete_checklistDelete a checklist and all its items
    create_checklist_itemAdd an item to a checklist
    edit_checklist_itemUpdate a checklist item (name, resolved, assignee, nesting)
    delete_checklist_itemRemove an item from a checklist
    Sprintsget_active_sprintAuto-detect the currently active sprint; returns tasks if exactly one found
    list_sprintsList all sprints in a folder
    get_sprint_tasksGet tasks for a specific sprint list
    Listslist_listsRetrieve lists in a space (folderless) or in a folder
    get_listGet list details
    create_listCreate a list in a space or folder
    create_list_from_templateCreate a new list from a template
    update_listUpdate list properties
    delete_listDelete a list
    move_listMove a list to a different space or folder (high-integrity)
    set_list_permissionsUpdate list privacy and sharing (ACLs)
    Custom Fieldslist_custom_fieldsList field definitions for a list, folder, or space
    create_custom_fieldAdd a new field definition to a list
    set_custom_field_valueSet a field value on a task
    remove_custom_field_valueClear a field value from a task
    Spaceslist_spacesList all spaces in the workspace
    get_spaceGet space details
    create_spaceCreate a new space
    update_spaceUpdate space properties
    delete_spaceDelete a space
    set_space_permissionsUpdate space privacy and sharing (ACLs)
    Goalslist_goalsList all goals in the workspace
    get_goalGet a goal with its key results
    create_goalCreate a new goal
    update_goalUpdate a goal's properties
    delete_goalDelete a goal
    create_key_resultAdd a key result to a goal
    update_key_resultUpdate a key result
    delete_key_resultDelete a key result
    Viewslist_viewsList views for a space, folder, list, or workspace
    get_viewGet a single view
    create_viewCreate a new view
    update_viewUpdate a view
    delete_viewDelete a view
    get_view_tasksGet tasks in a view
    Folderslist_foldersList all folders in a space
    get_folderGet folder details and its contained lists
    create_folderCreate a folder in a space
    update_folderUpdate folder properties
    delete_folderDelete a folder
    move_folderMove a folder to a different space (high-integrity)
    set_folder_permissionsUpdate folder privacy and sharing (ACLs)
    create_folder_from_templateCreate a folder from a template in a space
    Tagslist_space_tagsList all tags in a space
    create_space_tagCreate a new space tag
    update_space_tagUpdate a space tag's name or colors
    delete_space_tagDelete a tag from a space
    add_tag_to_taskAdd tag to task
    remove_tag_from_taskRemove tag from task
    Time Trackingget_time_entriesFetch historical time entries
    get_current_time_entryGet currently running timer
    start_time_entryStart tracking time for a task
    stop_time_entryStop the active timer
    add_time_entryManually log a time entry
    update_time_entryModify an existing time entry
    delete_time_entryDelete a time entry
    get_time_entry_tagsFetch all workspace time entry tags
    add_time_entry_tagsAdd a tag to a time entry
    update_time_entry_tagsRename a workspace time entry tag globally
    delete_time_entry_tagsRemove a tag from a time entry
    get_time_entry_historyView edit history of a time entry
    get_time_in_statusGet time-in-status for multiple tasks
    Docslist_documentsList documents in a workspace or container
    get_documentGet document metadata
    create_documentCreate a new standalone document
    list_document_pagesList all pages in a document
    get_document_pageGet content for a single page
    get_document_pagesGet content for multiple pages in one call
    create_document_pageAdd a new page to a document
    update_document_pageModify an existing page (replace/append/prepend)
    Chatlist_chat_channelsList all channels in the workspace
    get_chat_channelGet a single channel
    create_chat_channelCreate a new channel
    update_chat_channelUpdate a channel
    delete_chat_channelDelete a channel
    get_chat_channel_membersGet members of a channel
    get_chat_channel_followersGet followers of a channel
    create_chat_dmCreate a direct message channel
    get_chat_messagesGet messages from a channel
    create_chat_messageSend a message to a channel
    update_chat_messageEdit a message
    delete_chat_messageDelete a message
    get_chat_message_repliesGet threaded replies to a message
    create_chat_message_replyReply to a message in a thread
    add_chat_reactionAdd an emoji reaction to a message
    remove_chat_reactionRemove an emoji reaction
    get_chat_reactionsGet all reactions on a message
    get_chat_tagged_usersGet users tagged in a message
    get_chat_message_subtypesGet post subtype IDs for the workspace
    Webhookslist_webhooksList all webhooks in the workspace
    create_webhookCreate a new webhook
    update_webhookUpdate an existing webhook
    delete_webhookDelete a webhook permanently
    User Groupslist_user_groupsList all user groups in the workspace
    create_user_groupCreate a new user group
    update_user_groupRename a group or add/remove members
    delete_user_groupDelete a user group
    Guestsinvite_guestInvite a guest to the workspace (Enterprise)
    get_guestGet guest details (Enterprise)
    edit_guestEdit guest display name or permissions (Enterprise)
    remove_guestRemove a guest from the workspace (Enterprise)
    add_guest_to_taskGrant guest access to a task (Enterprise)
    remove_guest_from_taskRevoke guest access from a task (Enterprise)
    add_guest_to_listGrant guest access to a list (Enterprise)
    remove_guest_from_listRevoke guest access from a list (Enterprise)
    add_guest_to_folderGrant guest access to a folder (Enterprise)
    remove_guest_from_folderRevoke guest access from a folder (Enterprise)
    Task Templatesget_task_templatesList available workspace templates
    create_task_from_templateCreate a task from a template
    Feedbacksubmit_feedbackSubmit 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. There are 3 ways to do this. You can filter by exact tool name, by tool category, by personas (presets), or a combination of all three.

    Local (Environment Variable):

    json
    "ENABLED_TOOLS": "tool_1,tool_2,tool_3",
    "ENABLED_CATEGORIES": "task,time_tracking,workspace"

    -or- Hermes (YAML):

    yaml
    mcp_servers:
      clickup:
        env:
          ENABLED_TOOLS: "tool_1,tool_2,tool_3"
          ENABLED_CATEGORIES: "task,time_tracking,workspace"

    -or- Remote (Header):

    json
    "X-Enabled-Tools": "tool_1,tool_2,tool_3",
    "X-Enabled-Categories": "task,time_tracking,workspace"

    Preset Configurations

    Simplify setup by using Personas. You can set a persona via the CLICKUP_MCP_PERSONA environment variable or the X-Persona HTTP header to automatically filter a set of tools.

    Multiple personas can be combined (e.g., "X-Persona": "task_worker,time_specialist").

    Persona

    Description

    Target Use Case

    📋 auditor

    Read-only access

    View tasks, goals, docs, and chat (Read-only).

    👷 task_worker

    Daily management

    Task CRUD, time tracking, and checklists.

    ⏱️ time_specialist

    Time tracking focus

    Time logs, timesheets, and entry history.

    🏗️ project_manager

    High-level control

    Spaces, folders, lists, and bulk operations.

    📚 content_manager

    Communication

    Docs, chat, comments, and attachments.

    🏢 workspace_admin

    Admin control

    Permissions, guests, and audit logs.

    💻 developer

    Programmatic

    Webhooks, custom fields, bulk automation.

    🛡️ safe_power_user

    Full access

    All tools except destructive deletes/removals.

    Local (Environment Variable):

    json
    "CLICKUP_MCP_PERSONA": "task_worker"

    -or- Remote (Header):

    json
    "X-Persona": "task_worker"

    💡 Need to customize? To view the exact tools included in each preset or to build a custom list based on a persona, see the Personas Reference Guide.

    ---

    🌍 Multi-Workspace Support

    Simultaneously federate OAuth and multiple API keys to manage tasks across different authorized ClickUp accounts/workspaces in a single session. Easily move or duplicate tasks between workspaces, configure AI Agents for cross-workspace automation, and more.

    Remote (Headers):

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

    ---

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

    By using this software, you agree to our Terms of Service and acknowledge our Privacy Policy.

    Similar MCP

    Based on tags & features

    • AN

      Anilist Mcp

      TypeScript·
      57
    • MC

      Mcp Ipfs

      TypeScript·
      11
    • BI

      Biomcp

      Python·
      327
    • MC

      Mcp Open Library

      TypeScript·
      42

    Trending MCP

    Most active this week

    • PL

      Playwright Mcp

      TypeScript·
      22.1k
    • SE

      Serena

      Python·
      14.5k
    • MC

      Mcp Playwright

      TypeScript·
      4.9k
    • MC

      Mcp Server Cloudflare

      TypeScript·
      3.0k
    View All MCP Servers

    Similar MCP

    Based on tags & features

    • AN

      Anilist Mcp

      TypeScript·
      57
    • MC

      Mcp Ipfs

      TypeScript·
      11
    • BI

      Biomcp

      Python·
      327
    • MC

      Mcp Open Library

      TypeScript·
      42

    Trending MCP

    Most active this week

    • PL

      Playwright Mcp

      TypeScript·
      22.1k
    • SE

      Serena

      Python·
      14.5k
    • MC

      Mcp Playwright

      TypeScript·
      4.9k
    • MC

      Mcp Server Cloudflare

      TypeScript·
      3.0k