https://github.com/taazkareem/clickup-mcp-server
ClickUp MCP Server - Integrate ClickUp project management with AI through Model Context Protocol
https://github.com/taazkareem/clickup-mcp-server
ai antigravity-ide artificial-intelligence claude-code claude-desktop clickup clickup-api cursor-ai lists llm mcp mcp-server model-context-protocol productivity project-management roo-code spaces task-management tasks workspaces
Last synced: 4 months ago
JSON representation
ClickUp MCP Server - Integrate ClickUp project management with AI through Model Context Protocol
- Host: GitHub
- URL: https://github.com/taazkareem/clickup-mcp-server
- Owner: taazkareem
- License: other
- Created: 2025-12-24T22:49:26.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-01-18T09:06:42.000Z (4 months ago)
- Last Synced: 2026-01-18T17:29:45.982Z (4 months ago)
- Topics: ai, antigravity-ide, artificial-intelligence, claude-code, claude-desktop, clickup, clickup-api, cursor-ai, lists, llm, mcp, mcp-server, model-context-protocol, productivity, project-management, roo-code, spaces, task-management, tasks, workspaces
- Language: Dockerfile
- Homepage:
- Size: 8.66 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Security: docs/security-features.md
Awesome Lists containing this project
- metorial-index - ClickUp MCP Server - Integrate and manage ClickUp tasks, spaces, lists, and folders through a standard protocol for AI applications. Supports complete time tracking functionalities. (Task and Project Management)
- awesome-mcp - taazkareem/clickup-mcp-server - Integrate ClickUp project management with AI through Model Context Protocol ☆`19` (Productivity / Project Management)
- toolsdk-mcp-registry - ✅ @taazkareem/clickup-mcp-server
- awesome-mcp - taazkareem/clickup-mcp-server - ClickUp MCP Server is an MCP server that integrates ClickUp task management with AI applications, enabling AI agents to manage tasks, time tracking, documents, and workspace organization through a standardized protocol. (MCP Servers / Other MCP Servers)
README
# 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.*
> **Status Update:** Latest (v0.12.4) 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
## 💎 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
• Cancel anytime | • Pay once, use forever
• 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
👇 Click to view all 50+ available tools
| 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.*
---
## 🔌 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.
---
Created by taazkareem
This project is an independent work and is not officially associated with or sponsored by ClickUp.