# ClickUp MCP Server
[](https://www.npmjs.com/package/@taazkareem/clickup-mcp-server)
[](https://www.npmjs.com/package/@taazkareem/clickup-mcp-server)
[](LICENSE)
[](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.*
⭐️ 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>
