Content
<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, 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](#features)<br>• [Premium Access](#premium-access)<br>• [Available Tools](#available-tools)<br>• [Adv. Config](#advanced-configuration)<br>• [FAQ](#faq)<br>• [Disclaimer](#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/cursor-white.svg" height="16" style="vertical-align: middle;"> Cursor](#cursor-setup)</td> <td width="155" style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="./assets/logos/windsurf-white.svg" height="16" style="vertical-align: middle;"> Windsurf](#windsurf-setup)</td> <td width="140" 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](#vscode-setup)</td> <td width="140" 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](#roocode-setup)</td> </tr> <tr style="border: none;"> <td style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="./assets/logos/claude.svg" height="16" style="vertical-align: middle;"> Claude](#claude-desktop-setup)</td> <td st yle="border: none; vertical-align: middle; white-space: nowrap;">[<img src="https://cdn.simpleicons.org/anthropic/D97757" height="16" style="vertical-align: middle;"> Claude Code](#claude-code-setup)</td> <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](#n8n-setup)</td> <td style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="https://cdn.simpleicons.org/googlegemini/8E75C2" height="16" style="vertical-align: middle;"> Gemini CLI](#gemini-setup)</td> </tr> <tr style="border: none;"> <td style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="./assets/logos/antigravity.svg" height="16" style="vertical-align: middle;"> Antigravity](#antigravity-setup)</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](#codex-setup)</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](#chatgpt-setup)</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](#augment-setup)</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](#auggierun-setup)</td> <td style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="./assets/logos/openclaw-logo.svg" height="16" style="vertical-align: middle;"> OpenClaw](#openclaw-setup)</td> <td style="border: none; vertical-align: middle; white-space: nowrap;">[Other](#other-setup)</td> <td style="border: none; vertical-align: middle; white-space: nowrap;">[➕ Add Agent](mailto:info@taazkareem.com?subject=Redirect%20URI%20Whitelist%20Request)</td> </tr> </table> |
---
## <a name="features"></a>✨ Features
<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.
</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>
Create, update, move, delete, duplicate, link, and set dependencies between tasks. Supports bulk operations, nested subtasks, checklists, natural language dates, custom task IDs, custom task types, custom fields, and task templates.
</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.
</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 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. Switch workspaces mid-conversation without reconfiguration.
</td>
</tr>
</table>
---
## <a name="premium-access"></a>💎 Premium Access
**This project operates on a Sponsorware model.** A license grants **full access to all 48 premium tools** with any of the following plans:
<div align="center">
| [**Monthly ($9/mo)**](https://buy.polar.sh/polar_cl_3xQojQLgzQXKCLzsxc49YfL6z8hzSBBqh9ivy1qZdwW?utm_source=github&utm_medium=readme) | [**Annual ($59/yr)**](https://buy.polar.sh/polar_cl_3a8a3055T4CHIoVlSQPsNshOJLUwsM8AHAiIR3y9wTZ?utm_source=github&utm_medium=readme) | [**Lifetime ($89 w/ code**)](https://buy.polar.sh/polar_cl_4ha3uVyJTu4iPZJS1QbBYNTI1MKTvaXXCkZTb45vPPF?utm_source=github&utm_medium=readme) |
| :--- | :--- | :--- |
| • Pay-as-you-go flexibility<br>• 3 device activations<br>• Cancel anytime | • ONLY $4.92/mo <br>• 3 device activations<br>• Priority bug fixes | • **25% OFF** code: `MAR25` <br>• 3 device activations<br>• **Best Value** (One-time payment)|
<br>
**⚡️ Instant Delivery:** Your License Key is delivered immediately via **Polar.sh**. Total setup time is under 2 minutes.
<br>
[](https://buy.polar.sh/polar_cl_tZ2q8jRvtaaduurOkQKKJmRgdD43ZiB5K0GZn0aQcur?utm_source=github&utm_medium=readme)
</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](https://app.clickup.com/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
<a name="cursor-setup"></a>
<details open>
<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>
<a name="windsurf-setup"></a>
<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>
<a name="vscode-setup"></a>
<details>
<summary> <img src="./assets/logos/visual-studio-code.svg" height="22" align="center"> <strong>VS Code</strong></summary>
**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>
<a name="roocode-setup"></a>
<details>
<summary> <img src="https://avatars.githubusercontent.com/u/211522643?s=200&v=4" height="22" align="center" style="border-radius: 4px;"> <strong>Roo Code</strong></summary>
**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>
<a name="claude-desktop-setup"></a>
<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>
<a name="claude-code-setup"></a>
<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>
<a name="n8n-setup"></a>
<details>
<summary> <img src="https://cdn.simpleicons.org/n8n/FF6D5A" height="22" align="center"> <strong>n8n</strong></summary>
**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`
</details>
<a name="gemini-setup"></a>
<details>
<summary> <img src="https://cdn.simpleicons.org/googlegemini/8E75C2" height="22" align="center"> <strong>Gemini CLI</strong></summary>
**Configuration Path:** `~/.gemini/settings.json`
```json
{
"mcpServers": {
"ClickUp": {
"httpUrl": "https://clickup-mcp.taazkareem.com/mcp",
"headers": { "X-License-Key": "your-license-key" }
}
}
}
```
</details>
<a name="antigravity-setup"></a>
<details>
<summary> <img src="./assets/logos/antigravity.svg" height="22" align="center"> <strong>Antigravity</strong></summary>
**Configuration Path:** `~/.gemini/antigravity/mcp_config.json`
```json
{
"mcpServers": {
"ClickUp": {
"serverUrl": "https://clickup-mcp.taazkareem.com/mcp",
"headers": { "X-License-Key": "your-license-key" }
}
}
}
```
</details>
<a name="codex-setup"></a>
<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>
<a name="chatgpt-setup"></a>
<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.*
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**.
</details>
<a name="augment-setup"></a>
<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>
<a name="auggierun-setup"></a>
<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>
<a name="openclaw-setup"></a>
<details>
<summary> <img src="./assets/logos/openclaw-logo.svg" height="22" align="center"> <strong>OpenClaw (via mcporter) </strong></summary>
**1. Enable** the mcporter skill in `~/.openclaw/openclaw.json`:
```json
{"skills": {"allowBundled": ["mcporter"]}}
```
**2. Configure**
The fastest way to configure the server is using the `mcporter` CLI. Run one of the following commands in your terminal:
**Option A: Local (Recommended)**
*Saves to `<project-root>/config/mcporter.json`*
```bash
mcporter config add ClickUp https://clickup-mcp.taazkareem.com/mcp \
--auth oauth \
--header "X-License-Key=your-license-key"
```
**Option B: Global**
*Saves to `~/.mcporter/mcporter.json`*
```bash
mcporter config add ClickUp https://clickup-mcp.taazkareem.com/mcp \
--scope home \
--auth oauth \
--header "X-License-Key=your-license-key"
```
**3. Authenticate** — run once to authorize via browser (tokens are cached):
```bash
mcporter auth ClickUp
```
**4. Use:**
```bash
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.
</details>
<a name="other-setup"></a>
<details>
<summary> <strong>Other (Custom Agents, etc.)</strong></summary>
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:**
```python
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.")
```
</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 48 available tools</strong></summary>
| 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 Deep Search filtering |
| | `manage_comments` | Get, create, update, delete comments and replies on tasks, lists, or views |
| | `attach_task_file` | Attach file to a task |
| | `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 |
| **Checklists** | `manage_checklists` | Create, edit, delete checklists and checklist items on tasks |
| **Lists** | `manage_lists` | Create, get, update, delete, move lists; get folderless lists in a space |
| **Custom Fields** | `manage_custom_fields` | Manage field definitions and task values (consolidated) |
| **Spaces** | `manage_spaces` | List, get, create, update, or delete spaces |
| **Goals** | `manage_goals` | List, get, create, update, or delete goals; manage key results |
| **Views** | `manage_views` | List, get, create, update, or delete views; get tasks from view |
| **Folders** | `manage_folders` | Create, get, update, delete, move folders in a space |
| **Tags** | `manage_space_tags` | List, create, update, or delete space tags |
| | `add_tag_to_task` | Add tag to task |
| | `remove_tag_from_task` | Remove tag from task |
| **Time Tracking** | `manage_time_entries` | Unified tool for tracking time, log manual entries, and tag timers |
| **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** | `manage_chat_channels` | List, get, create, update, delete channels; get members/followers; create DMs |
| | `manage_chat_messages` | Get, create, update, delete messages; threaded replies; reactions; tagged users |
| **Webhooks** | `manage_webhooks` | Create, get, update, or delete webhooks |
| **User Groups** | `manage_user_groups` | List, create, update, and delete workspace user groups |
| **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](docs/DOCUMENTATION.md) 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.
**Local (Environment Variable):**
```json
"ENABLED_TOOLS": "tool_1,tool_2,tool_3"
```
-or- **Remote (Header):**
```json
"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.
<details>
<summary><strong>📋 Auditor</strong></summary>
Best for agents that need to view data without making any changes. Includes read access for tasks, structural elements, goals, docs, and chat.
**HTTP Header:**
`X-Enabled-Tools: get_workspace_hierarchy,get_workspace_members,find_member_by_name,get_task,get_workspace_tasks,manage_comments,get_task_links,manage_lists,manage_custom_fields,manage_spaces,manage_goals,manage_views,manage_folders,manage_time_entries,get_document,list_documents,list_document_pages,get_document_pages,manage_chat_channels,manage_chat_messages,get_task_templates,manage_user_groups,submit_feedback`
**JSON / Env:**
```json
"env": {
"ENABLED_TOOLS": "get_workspace_hierarchy,get_workspace_members,find_member_by_name,get_task,get_workspace_tasks,manage_comments,get_task_links,manage_lists,manage_custom_fields,manage_spaces,manage_goals,manage_views,manage_folders,manage_time_entries,get_document,list_documents,list_document_pages,get_document_pages,manage_chat_channels,manage_chat_messages,get_task_templates,manage_user_groups,submit_feedback"
}
```
</details>
<details>
<summary><strong>👷 Task Worker</strong></summary>
Focused on day-to-day task management. Can create/update/delete tasks, track time, manage checklists, and update goals. Cannot modify workspace structure (Lists/Folders).
**HTTP Header:**
`X-Enabled-Tools: get_workspace_hierarchy,find_member_by_name,create_task,get_task,update_task,manage_custom_fields,move_task,duplicate_task,delete_task,get_workspace_tasks,manage_comments,attach_task_file,add_task_to_list,remove_task_from_list,add_task_link,get_task_links,delete_task_link,add_task_dependency,delete_task_dependency,manage_checklists,manage_lists,manage_goals,manage_views,manage_folders,add_tag_to_task,remove_tag_from_task,manage_time_entries,get_task_templates,create_task_from_template,manage_webhooks,manage_user_groups,submit_feedback`
**JSON / Env:**
```json
"env": {
"ENABLED_TOOLS": "get_workspace_hierarchy,find_member_by_name,create_task,get_task,update_task,manage_custom_fields,move_task,duplicate_task,delete_task,get_workspace_tasks,manage_comments,attach_task_file,add_task_to_list,remove_task_from_list,add_task_link,get_task_links,delete_task_link,add_task_dependency,delete_task_dependency,manage_checklists,manage_lists,manage_goals,manage_views,manage_folders,add_tag_to_task,remove_tag_from_task,manage_time_entries,get_task_templates,create_task_from_template,manage_webhooks,manage_user_groups,submit_feedback"
}
```
</details>
<details>
<summary><strong>⏱️ Time Specialist</strong></summary>
For agents dedicated to logging time and generating timesheets.
**HTTP Header:**
`X-Enabled-Tools: get_workspace_hierarchy,find_member_by_name,get_task,get_workspace_tasks,manage_time_entries,submit_feedback`
**JSON / Env:**
```json
"env": {
"ENABLED_TOOLS": "get_workspace_hierarchy,find_member_by_name,get_task,get_workspace_tasks,manage_time_entries,submit_feedback"
}
```
</details>
<details>
<summary><strong>🏗️ Project Manager</strong></summary>
Workspace building and alignment. Creates spaces, folders, lists, and goals. Handles bulk task operations and templates.
**HTTP Header:**
`X-Enabled-Tools: get_workspace_hierarchy,get_workspace_members,find_member_by_name,create_task,get_task,update_task,get_workspace_tasks,create_bulk_tasks,update_bulk_tasks,move_bulk_tasks,delete_bulk_tasks,manage_lists,manage_custom_fields,manage_spaces,manage_goals,manage_views,manage_folders,manage_space_tags,add_task_dependency,delete_task_dependency,get_task_templates,create_task_from_template,manage_webhooks,manage_user_groups,submit_feedback`
**JSON / Env:**
```json
"env": {
"ENABLED_TOOLS": "get_workspace_hierarchy,get_workspace_members,find_member_by_name,create_task,get_task,update_task,get_workspace_tasks,create_bulk_tasks,update_bulk_tasks,move_bulk_tasks,delete_bulk_tasks,manage_lists,manage_custom_fields,manage_spaces,manage_goals,manage_views,manage_folders,manage_space_tags,add_task_dependency,delete_task_dependency,get_task_templates,create_task_from_template,manage_webhooks,manage_user_groups,submit_feedback"
}
```
</details>
<details>
<summary><strong>📚 Content Manager</strong></summary>
For agents managing documentation and communication.
**HTTP Header:**
`X-Enabled-Tools: get_workspace_hierarchy,find_member_by_name,get_task,get_workspace_tasks,manage_comments,manage_views,create_document,get_document,list_documents,list_document_pages,get_document_pages,create_document_page,update_document_page,manage_chat_channels,manage_chat_messages,submit_feedback`
**JSON / Env:**
```json
"env": {
"ENABLED_TOOLS": "get_workspace_hierarchy,find_member_by_name,get_task,get_workspace_tasks,manage_comments,manage_views,create_document,get_document,list_documents,list_document_pages,get_document_pages,create_document_page,update_document_page,manage_chat_channels,manage_chat_messages,submit_feedback"
}
```
</details>
<details>
<summary><strong>🛡️ Safe Power User</strong></summary>
Enables everything **except** standalone destructive tools. This configuration covers **all 48 tools** by default, only blocking the 4 specific deletion tools listed below. Useful for capable agents that need full access but shouldn't destroy data. Note: consolidated tools (`manage_lists`, `manage_folders`, `manage_checklists`) include delete actions internally — use system prompts to instruct the agent to avoid destructive actions if needed.
**HTTP Header:**
`X-Disabled-Tools: delete_task,delete_bulk_tasks,delete_task_link,delete_task_dependency`
**JSON / Env:**
```json
"env": {
"DISABLED_TOOLS": "delete_task,delete_bulk_tasks,delete_task_link,delete_task_dependency"
}
```
</details>
---
## <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](https://github.com/TaazKareem/clickup-mcp-server/issues) 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.
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.
<div align="center">
<sub>Created by <a href="https://github.com/taazkareem">taazkareem</a></sub>
</div>
