# ClickUp MCP Server
![ClickUp MCP Server Premium Image](https://raw.githubusercontent.com/taazkareem/clickup-mcp-server/main/assets/images/header_image.png)

[![npm version](https://img.shields.io/npm/v/@taazkareem/clickup-mcp-server.svg)](https://www.npmjs.com/package/@taazkareem/clickup-mcp-server)
[![npm downloads](https://img.shields.io/npm/dm/@taazkareem/clickup-mcp-server.svg)](https://www.npmjs.com/package/@taazkareem/clickup-mcp-server)
[![License](https://img.shields.io/badge/License-Proprietary-red.svg)](LICENSE)
[![Maintained](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/TaazKareem/clickup-mcp-server/graphs/commit-activity)

**Connect ClickUp to AI Agents including Claude Desktop, Cursor IDE, n8n, and Gemini CLI.**
*A high-performance Model Context Protocol (MCP) server for managing tasks, tags, lists, folders, files, docs, time, and chat using natural language.*

> **Status Update:** Latest (v0.12.5) update fixes Markdown Description support for the `get_task` tool to intelligently improve High-Fidelity Context.

⭐️ 460+ Stars (from previous public repo) - Industry-Standard ClickUp MCP Integration
<hr>


## 💎 Premium Access

**This project operates on a Sponsorware model.** To ensure dedicated maintenance, rapid API updates, and priority support, the source code and latest builds are exclusively available to supporters.

| **[Monthly Subscription ($9)](https://buy.polar.sh/polar_cl_3xQojQLgzQXKCLzsxc49YfL6z8hzSBBqh9ivy1qZdwW)** | **[Lifetime Access ($59)](https://buy.polar.sh/polar_cl_whcMn4lbBFwZUoWU5p2qDSn0fs23ACC6IwK3e15hXV5)** |
| :--- | :--- |
| • Perfect for ongoing projects<br>• Cancel anytime | • Pay once, use forever<br>• Best value for agencies |

> **Instant Access:** Licenses are delivered immediately via **Polar.sh**. Setup takes < 2 minutes.

---

## 🚀 Quick Start

### 1. Prerequisites
*   **Node.js v18.0.0+**
*   **License Key:** [Purchase here](https://buy.polar.sh/polar_cl_whcMn4lbBFwZUoWU5p2qDSn0fs23ACC6IwK3e15hXV5)
*   **ClickUp Credentials:** API Key & Team ID

### 2. Configure MCP Client
Add the following to your `claude_desktop_config.json` or similar MCP settings file:

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

### 3. Restart
Restart your MCP Host (e.g., Cursor IDE). The server will validate your license and start automatically.

---

## ✨ Features

Integrate ClickUp seamlessly with Natural Language for customized workflows

*   **📝 Task Management:** Create, update, move, duplicate, and link tasks. Supports bulk operations and natural language dates.
*   **⏱️ Time Tracking:** Start/stop timers, view entries, and manage billable time.
*   **📄 Docs & Knowledge:** Create, read, and append to ClickUp Documents. Full workspace hierarchy traversal.
*   **💬 Chat & Collaboration:** Send messages to channels, read history, and manage comments with Markdown support.
*   **🌳 Workspace Control:** Navigate spaces, folders, and lists. Manage tags and member assignments.

---

## ⚙️ Configuration

### Finding Your Credentials

1.  **ClickUp API Key:**
    *   Navigate to [ClickUp Settings → Apps](https://app.clickup.com/settings/apps).
    *   Generate a token under "API Token".
2.  **ClickUp Team ID:**
    *   Open ClickUp in your browser.
    *   Look at the URL: `https://app.clickup.com/[TEAM_ID]/v/...`
    *   The first number is your Team ID.
    *   *Note: ClickUp API calls this `team_id`, but it actually represents your Workspace ID.*

### Tool Filtering (Optional)
Reduce context noise by limiting available tools. Add this to your `env` configuration:

```json
"ENABLED_TOOLS": "create_task,get_task,update_task,get_workspace_hierarchy"
```

---

## 🛠️ Available Tools

<details>
<summary><strong>👇 Click to view all 50+ 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 |
| | `create_bulk_tasks` | Create multiple tasks |
| | `update_task` | Modify task |
| | `update_bulk_tasks` | Update multiple tasks |
| | `get_tasks` | Get tasks from list |
| | `get_task` | Get single task details |
| | `get_workspace_tasks` | Get tasks with filtering |
| | `delete_task` | Remove task |
| | `move_task` | Move task to new list |
| | `duplicate_task` | Copy task |
| | `add_task_link` | Link two tasks together |
| **Comments** | `get_task_comments` | Get comments on a task |
| | `create_task_comment` | Add a comment to a task |
| | `attach_task_file` | Attach file to a task |
| **Lists/Folders** | `create_list` | Create list in space/folder |
| | `create_folder` | Create folder |
| | `get_folder` | Get folder details |
| | `update_folder` | Update folder properties |
| **Tags** | `get_space_tags` | Get space tags |
| | `create_space_tag` | Create tag |
| | `add_tag_to_task` | Add tag to task |
| **Time** | `start_time_tracking` | Start time tracking |
| | `stop_time_tracking` | Stop current time tracking |
| | `get_task_time_entries` | Get time entries for a task |
| **Docs** | `create_document` | Create a document |
| | `get_document` | Get a document |
| | `list_documents` | List documents |
| **Chat** | `create_chat_channel` | Create a chat channel |
| | `create_chat_message` | Send a message to a channel |
| | `get_chat_messages` | Get message history |

*See [full documentation](docs/user-guide.md) for parameters and advanced usage.*
</details>

---

## 🔌 Compatibility

This server supports  **STDIO, HTTP Streamable, and SSE (Server-Sent Events)** for legacy integrations.

**Configuration:**
```json
{
  "env": {
    "ENABLE_SSE": "true",
    "PORT": "3231"
  }
}
```

**n8n Setup:**
1.  Set `ENABLE_SSE` to "true" and run the server.
2.  In n8n, add an **"MCP AI Tool"** node.
3.  Set Transport to `SSE` and URL to `http://localhost:3231/sse`.

---

## ❓ FAQ

**Why isn't this free anymore?**
Building reliable MCP integrations requires significant maintenance. Moving to a paid model allows us to support this as a product rather than a hobby, ensuring compatibility with API changes.

**I have an old version. Will it stop working?**
Existing local clones will continue to work, but you will not receive updates, bug fixes, or support without a license.

**How do I get support?**
Premium users get priority support. Please [open an issue](https://github.com/TaazKareem/clickup-mcp-server/issues) in this repository.

---

<div align="center">
  <sub>Created by <a href="https://github.com/taazkareem">taazkareem</a></sub>
  <br>
  <sub>This project is an independent work and is not officially associated with or sponsored by ClickUp.</sub>
</div>
ClickUp

README

Installation
