io.github.taazkareem/clickup

Name: io.github.taazkareem/clickup
Rating: 2.5 (50 reviews)
Author: taazkareem

编码与调试

by taazkareem

面向 ClickUp 的高级 AI 集成，涵盖 tasks、lists、docs、folders 与 time，含 50+ tools，开箱即用。

什么是 io.github.taazkareem/clickup？

面向 ClickUp 的高级 AI 集成，涵盖 tasks、lists、docs、folders 与 time，含 50+ tools，开箱即用。

README

<h1 align="center">ClickUp MCP Server — Premium</h1> <p align="center"> <img src="https://raw.githubusercontent.com/taazkareem/clickup-mcp-server/main/assets/images/clickup_mcp_neon_logo_blue.jpg" alt="ClickUp MCP Server Premium Logo" width="100%"> </p> <p align="center"> <a href="https://www.npmjs.com/package/@taazkareem/clickup-mcp-server"><img src="https://img.shields.io/npm/v/@taazkareem/clickup-mcp-server.svg" alt="npm version"></a> <a href="https://www.npmjs.com/package/@taazkareem/clickup-mcp-server"><img src="https://img.shields.io/npm/dm/@taazkareem/clickup-mcp-server.svg" alt="npm downloads"></a> <img src="https://img.shields.io/badge/License-Proprietary-red.svg" alt="License"> <img src="https://img.shields.io/badge/Ranked_Top_3_on_Google-🔥-orange.svg" alt="Top 3 on Google"> <img src="https://img.shields.io/badge/Trending-MCP_Server-blueviolet.svg" alt="Trending MCP Server"> <a href="https://github.com/TaazKareem/clickup-mcp-server/graphs/commit-activity"><img src="https://img.shields.io/badge/Maintained%3F-yes-blue.svg" alt="Maintained"></a> </p>

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

Links	Quick Start & Installation
• Features<br>• Premium Access<br>• Available Tools<br>• Adv. Config<br>• FAQ<br>• Disclaimer	<table border="0" style="border: none; border-collapse: collapse; width: 575px;"> <tr style="border: none;"> <td width="140" style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/antigravity.svg" height="16" style="vertical-align: middle;"> Antigravity</td> <td width="155" style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/antigravity.svg" height="16" style="vertical-align: middle;"> Agy CLI</td> <td width="140" style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/images/hermes-logo.png" height="16" style="vertical-align: middle;"> Hermes</td> <td width="140" style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/openclaw-logo.svg" height="16" style="vertical-align: middle;"> OpenClaw</td> </tr> <tr style="border: none;"> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/cursor-white.svg" height="16" style="vertical-align: middle;"> Cursor</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/visual-studio-code.svg" height="16" style="vertical-align: middle;"> VS Code</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/claude.svg" height="16" style="vertical-align: middle;"> Claude</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="https://cdn.simpleicons.org/anthropic/D97757" height="16" style="vertical-align: middle;"> ClaudeCode</td> </tr> <tr style="border: none;"> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="https://cdn.simpleicons.org/n8n/FF6D5A" height="16" style="vertical-align: middle;"> n8n</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/openai-icon.svg" height="16" style="vertical-align: middle;"> Codex</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/openai-icon.svg" height="16" style="vertical-align: middle;"> ChatGPT</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/augment-code.svg" height="16" style="vertical-align: middle;"> Augment</td> </tr> <tr style="border: none;"> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/augment-code.svg" height="16" style="vertical-align: middle;"> Auggie</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="./assets/logos/windsurf-white.svg" height="16" style="vertical-align: middle;"> Windsurf</td> <td style="border: none; vertical-align: middle; white-space: nowrap;"><img src="https://avatars.githubusercontent.com/u/211522643?s=200&v=4" height="16" style="vertical-align: middle; border-radius: 4px;"> Roo Code</td> <td style="border: none; vertical-align: middle; white-space: nowrap;">➕ Add Agent</td> </tr> </table>

Links

Quick Start & Installation

• Features<br>• Premium Access<br>• Available Tools<br>• Adv. Config<br>• FAQ<br>• Disclaimer

<a name="features"></a>✨ Features

🔥 Multi-Account Support: Manage multiple authorized workspaces seamlessly in a single session. See setup

<table border="0" style="width: 100%; border-collapse: collapse;"> <tr style="border: none;"> <td width="50%" style="vertical-align: top; border: none; padding-bottom: 20px;"> <strong>🔐 Hybrid Authentication</strong><br> 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). </td> <td width="50%" style="vertical-align: top; border: none; padding-bottom: 20px;"> <strong>🔍 Intelligent Search & Resolution</strong><br> 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. </td> </tr> <tr style="border: none;"> <td style="vertical-align: top; border: none; padding-bottom: 20px;"> <strong>📝 Task Management</strong><br> 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). </td> <td style="vertical-align: top; border: none; padding-bottom: 20px;"> <strong>⏱️ Time Tracking</strong><br> 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. </td> </tr> <tr style="border: none;"> <td style="vertical-align: top; border: none; padding-bottom: 20px;"> <strong>📄 Document Management</strong><br> Create, read, and append to ClickUp Docs with full markdown text. Manage pages within documents for structured, long-form content (consolidated action-based tool). </td> <td style="vertical-align: top; border: none; padding-bottom: 20px;"> <strong>💬 Comments & Chat</strong><br> 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. </td> </tr> <tr style="border: none;"> <td style="vertical-align: top; border: none; padding-bottom: 20px;"> <strong>🎯 Goals & Key Results</strong><br> 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. </td> <td style="vertical-align: top; border: none; padding-bottom: 20px;"> <strong>📋 Views</strong><br> 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. </td> </tr> <tr style="border: none;"> <td style="vertical-align: top; border: none;"> <strong>🗂️ Task Templates</strong><br> Browse available task templates and instantly create tasks from them. Streamlines repeatable workflows without manual setup each time. </td> <td style="vertical-align: top; border: none;"> <strong>🌳 Workspace Control</strong><br> 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. </td> </tr> </table>

<a name="premium-access"></a>💎 Premium Access

<div align="center"> <h3>Unlock 150 Enterprise-Grade Custom Tools</h3>

This project transitioned from open-source to a paid model for sustainable full-time development and priority support. A license grants full, unrestricted access to all features across your agents⎯no limits.

<br>

Monthly $9/mo	Annual $59/yr	Lifetime <!--LIFETIME_HEADER-->$89 w/ code<!--/LIFETIME_HEADER-->
• Pay-as-you-go flexibility<br>• 3 device activations<br>• Cancel anytime	• Save 45% ($4.92/mo)<br>• 3 device activations<br>• Priority support all year	• Best Value — One payment<br>• 3 device activations<br>• <!--LIFETIME_DETAIL-->25% OFF code: `AUG25`<!--/LIFETIME_DETAIL-->

⚡️ Instant Key Delivery (Polar.sh) • Setup takes less than 2 mins

</div>

🚀 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

<details> <summary> <img src="./assets/logos/antigravity.svg" height="22" align="center"> <strong>Antigravity (IDE & 2.0)</strong></summary>

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

</details>

<details> <summary> <img src="./assets/logos/antigravity.svg" height="22" align="center"> <strong>Antigravity CLI (agy)</strong></summary>

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

</details>

<details> <summary> <img src="./assets/images/hermes-logo.png" height="22" align="center"> <strong>Hermes Agent</strong></summary>

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/<name>/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

</details>

<details> <summary> <img src="./assets/logos/openclaw-logo.svg" height="22" align="center"> <strong>OpenClaw (via mcporter) </strong></summary>

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.

</details>

<details> <summary> <img src="./assets/logos/cursor-white.svg" height="22" align="center"> <strong>Cursor</strong></summary>

Configuration Path: <project-root>/.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"
      }
    }
  }
}

</details>

Configuration Paths:

Global: ~/Library/Application Support/Code/User/mcp.json
Local: <project-root>/.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"
      }
    }
  }
}

</details>

Configuration Path: <project-root>/.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"
      }
    }
  }
}

</details>

<details> <summary> <img src="./assets/logos/claude.svg" height="22" align="center"> <strong>Claude Desktop</strong></summary>

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"
      ]
    }
  }
}

</details>

<details> <summary> <img src="https://cdn.simpleicons.org/anthropic/D97757" height="22" align="center"> <strong>Claude Code (CLI)</strong></summary>

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"

</details>

Option A: Remote / Streamable HTTP (Recommended)

In n8n, add an "MCP Client" node.
Set Connection Type to Streamable HTTP.
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:

bash

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

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

</details>

<details> <summary> <img src="./assets/logos/openai-icon.svg" height="22" align="center"> <strong>Codex (CLI, Desktop, IDE)</strong></summary>

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

Configuration Paths:

Global: ~/.codex/config.toml
Local: <project-root>/.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.

</details>

<details> <summary> <img src="./assets/logos/openai-icon.svg" height="22" align="center"> <strong>ChatGPT (Developer Mode)</strong></summary>

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.

</details>

<details> <summary> <img src="./assets/logos/augment-code.svg" height="22" align="center"> <strong>Augment Code</strong></summary>

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

json

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

</details>

<details> <summary> <img src="./assets/logos/augment-code.svg" height="22" align="center"> <strong>Auggie CLI</strong></summary>

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"

</details>

<details> <summary> <img src="./assets/logos/windsurf-white.svg" height="22" align="center"> <strong>Windsurf</strong></summary>

Configuration Path: <project-root>/.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"
      }
    }
  }
}

</details>

3. Restart

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

<a name="available-tools"></a>🛠️ Available Tools

<details> <summary><strong>👇 Click to view all 150 available tools</strong></summary>

Category	Tool	Description
Workspace	`get_workspace`	Get workspace structure and metadata (hierarchy, members, plan, seats, shared items, custom task types)
	`get_workspace_seats`	Get member and guest seat utilization (used, total, available)
	`get_workspace_plan`	Get plan details for the workspace (plan_name, plan_id)
	`get_audit_logs`	Retrieve workspace audit logs (Enterprise only)
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 Deep Search filtering
	`get_comments`	Get comments on a task, list, or view
	`create_comment`	Create a comment on a task, list, or view
	`update_comment`	Edit or resolve a comment
	`delete_comment`	Delete a comment
	`get_comment_replies`	Get threaded replies for a comment
	`create_comment_reply`	Reply to a comment in a thread
	`add_comment_reaction`	Add an emoji reaction to a comment
	`remove_comment_reaction`	Remove an emoji reaction from a comment
	`get_comment_subtypes`	Get post subtype IDs for the workspace
	`add_task_link`	Link two tasks together
	`get_task_links`	Get task links
	`delete_task_link`	Remove a task link
	`add_task_dependency`	Set a blocking dependency between tasks
	`delete_task_dependency`	Remove a blocking dependency between tasks
Attachments	`list_attachments`	List attachments for a task or file custom field (v3)
	`get_attachment`	Get a specific attachment by ID or name (v3)
	`upload_attachment`	Upload a file to a task or file custom field (v3)
Checklists	`create_checklist`	Add a checklist to a task
	`edit_checklist`	Rename or reorder a checklist
	`delete_checklist`	Delete a checklist and all its items
	`create_checklist_item`	Add an item to a checklist
	`edit_checklist_item`	Update a checklist item (name, resolved, assignee, nesting)
	`delete_checklist_item`	Remove an item from a checklist
Sprints	`get_active_sprint`	Auto-detect the currently active sprint; returns tasks if exactly one found
	`list_sprints`	List all sprints in a folder
	`get_sprint_tasks`	Get tasks for a specific sprint list
Lists	`list_lists`	Retrieve lists in a space (folderless) or in a folder
	`get_list`	Get list details
	`create_list`	Create a list in a space or folder
	`create_list_from_template`	Create a new list from a template
	`update_list`	Update list properties
	`delete_list`	Delete a list
	`move_list`	Move a list to a different space or folder (high-integrity)
	`set_list_permissions`	Update list privacy and sharing (ACLs)
Custom Fields	`list_custom_fields`	List field definitions for a list, folder, or space
	`create_custom_field`	Add a new field definition to a list
	`set_custom_field_value`	Set a field value on a task
	`remove_custom_field_value`	Clear a field value from a task
Spaces	`list_spaces`	List all spaces in the workspace
	`get_space`	Get space details
	`create_space`	Create a new space
	`update_space`	Update space properties
	`delete_space`	Delete a space
	`set_space_permissions`	Update space privacy and sharing (ACLs)
Goals	`list_goals`	List all goals in the workspace
	`get_goal`	Get a goal with its key results
	`create_goal`	Create a new goal
	`update_goal`	Update a goal's properties
	`delete_goal`	Delete a goal
	`create_key_result`	Add a key result to a goal
	`update_key_result`	Update a key result
	`delete_key_result`	Delete a key result
Views	`list_views`	List views for a space, folder, list, or workspace
	`get_view`	Get a single view
	`create_view`	Create a new view
	`update_view`	Update a view
	`delete_view`	Delete a view
	`get_view_tasks`	Get tasks in a view
Folders	`list_folders`	List all folders in a space
	`get_folder`	Get folder details and its contained lists
	`create_folder`	Create a folder in a space
	`update_folder`	Update folder properties
	`delete_folder`	Delete a folder
	`move_folder`	Move a folder to a different space (high-integrity)
	`set_folder_permissions`	Update folder privacy and sharing (ACLs)
	`create_folder_from_template`	Create a folder from a template in a space
Tags	`list_space_tags`	List all tags in a space
	`create_space_tag`	Create a new space tag
	`update_space_tag`	Update a space tag's name or colors
	`delete_space_tag`	Delete a tag from a space
	`add_tag_to_task`	Add tag to task
	`remove_tag_from_task`	Remove tag from task
Time Tracking	`get_time_entries`	Fetch historical time entries
	`get_current_time_entry`	Get currently running timer
	`start_time_entry`	Start tracking time for a task
	`stop_time_entry`	Stop the active timer
	`add_time_entry`	Manually log a time entry
	`update_time_entry`	Modify an existing time entry
	`delete_time_entry`	Delete a time entry
	`get_time_entry_tags`	Fetch all workspace time entry tags
	`add_time_entry_tags`	Add a tag to a time entry
	`update_time_entry_tags`	Rename a workspace time entry tag globally
	`delete_time_entry_tags`	Remove a tag from a time entry
	`get_time_entry_history`	View edit history of a time entry
	`get_time_in_status`	Get time-in-status for multiple tasks
Docs	`list_documents`	List documents in a workspace or container
	`get_document`	Get document metadata
	`create_document`	Create a new standalone document
	`list_document_pages`	List all pages in a document
	`get_document_page`	Get content for a single page
	`get_document_pages`	Get content for multiple pages in one call
	`create_document_page`	Add a new page to a document
	`update_document_page`	Modify an existing page (replace/append/prepend)
Chat	`list_chat_channels`	List all channels in the workspace
	`get_chat_channel`	Get a single channel
	`create_chat_channel`	Create a new channel
	`update_chat_channel`	Update a channel
	`delete_chat_channel`	Delete a channel
	`get_chat_channel_members`	Get members of a channel
	`get_chat_channel_followers`	Get followers of a channel
	`create_chat_dm`	Create a direct message channel
	`get_chat_messages`	Get messages from a channel
	`create_chat_message`	Send a message to a channel
	`update_chat_message`	Edit a message
	`delete_chat_message`	Delete a message
	`get_chat_message_replies`	Get threaded replies to a message
	`create_chat_message_reply`	Reply to a message in a thread
	`add_chat_reaction`	Add an emoji reaction to a message
	`remove_chat_reaction`	Remove an emoji reaction
	`get_chat_reactions`	Get all reactions on a message
	`get_chat_tagged_users`	Get users tagged in a message
	`get_chat_message_subtypes`	Get post subtype IDs for the workspace
Webhooks	`list_webhooks`	List all webhooks in the workspace
	`create_webhook`	Create a new webhook
	`update_webhook`	Update an existing webhook
	`delete_webhook`	Delete a webhook permanently
User Groups	`list_user_groups`	List all user groups in the workspace
	`create_user_group`	Create a new user group
	`update_user_group`	Rename a group or add/remove members
	`delete_user_group`	Delete a user group
Guests	`invite_guest`	Invite a guest to the workspace (Enterprise)
	`get_guest`	Get guest details (Enterprise)
	`edit_guest`	Edit guest display name or permissions (Enterprise)
	`remove_guest`	Remove a guest from the workspace (Enterprise)
	`add_guest_to_task`	Grant guest access to a task (Enterprise)
	`remove_guest_from_task`	Revoke guest access from a task (Enterprise)
	`add_guest_to_list`	Grant guest access to a list (Enterprise)
	`remove_guest_from_list`	Revoke guest access from a list (Enterprise)
	`add_guest_to_folder`	Grant guest access to a folder (Enterprise)
	`remove_guest_from_folder`	Revoke guest access from a folder (Enterprise)
Task Templates	`get_task_templates`	List available workspace templates
	`create_task_from_template`	Create a task from a template
Feedback	`submit_feedback`	Submit feedback or bug reports

See full documentation for parameters and advanced usage.

</details>

<a name="advanced-configuration"></a>⚙️ 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").

<table border="0" style="width: 100%; border-collapse: collapse;"> <thead> <tr style="border-bottom: 1px solid #ddd;"> <th align="left" width="200" style="padding: 10px; white-space: nowrap;">Persona</th> <th align="left" width="180" style="padding: 10px;">Description</th> <th align="left" style="padding: 10px;">Target Use Case</th> </tr> </thead> <tbody> <tr style="border-bottom: 1px solid #eee;"> <td style="padding: 10px; white-space: nowrap;">📋 <code>auditor</code></td> <td style="padding: 10px;">Read-only access</td> <td style="padding: 10px;">View tasks, goals, docs, and chat (Read-only).</td> </tr> <tr style="border-bottom: 1px solid #eee;"> <td style="padding: 10px; white-space: nowrap;">👷 <code>task_worker</code></td> <td style="padding: 10px;">Daily management</td> <td style="padding: 10px;">Task CRUD, time tracking, and checklists.</td> </tr> <tr style="border-bottom: 1px solid #eee;"> <td style="padding: 10px; white-space: nowrap;">⏱️ <code>time_specialist</code></td> <td style="padding: 10px;">Time tracking focus</td> <td style="padding: 10px;">Time logs, timesheets, and entry history.</td> </tr> <tr style="border-bottom: 1px solid #eee;"> <td style="padding: 10px; white-space: nowrap;">🏗️ <code>project_manager</code></td> <td style="padding: 10px;">High-level control</td> <td style="padding: 10px;">Spaces, folders, lists, and bulk operations.</td> </tr> <tr style="border-bottom: 1px solid #eee;"> <td style="padding: 10px; white-space: nowrap;">📚 <code>content_manager</code></td> <td style="padding: 10px;">Communication</td> <td style="padding: 10px;">Docs, chat, comments, and attachments.</td> </tr> <tr style="border-bottom: 1px solid #eee;"> <td style="padding: 10px; white-space: nowrap;">🏢 <code>workspace_admin</code></td> <td style="padding: 10px;">Admin control</td> <td style="padding: 10px;">Permissions, guests, and audit logs.</td> </tr> <tr style="border-bottom: 1px solid #eee;"> <td style="padding: 10px; white-space: nowrap;">💻 <code>developer</code></td> <td style="padding: 10px;">Programmatic</td> <td style="padding: 10px;">Webhooks, custom fields, bulk automation.</td> </tr> <tr style="border-bottom: 1px solid #eee;"> <td style="padding: 10px; white-space: nowrap;">🛡️ <code>safe_power_user</code></td> <td style="padding: 10px;">Full access</td> <td style="padding: 10px;">All tools except destructive deletes/removals.</td> </tr> </tbody> </table>

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.

<a name="multi-workspace-support"></a>🌍 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"
      }
    }
  }
}

<a name="faq"></a>❓ 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.

<a name="disclaimer"></a>⚖️ Disclaimer

Originally developed as open source and refined during a consultancy with ClickUp, this project is now independently maintained.</sub>

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.</sub>

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

<div align="center"> <sub>Created by <a href="https://github.com/taazkareem">taazkareem</a></sub> </div>

常见问题