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
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) | Lifetime Access ($59) |
|---|---|
| • 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.
- Node.js v18.0.0+
- License Key: Purchase here
- ClickUp Credentials: API Key & Team ID
Add the following to your claude_desktop_config.json or similar MCP settings file:
{
"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"
}
}
}
}Restart your MCP Host (e.g., Cursor IDE). The server will validate your license and start automatically.
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.
- ClickUp API Key:
- Navigate to ClickUp Settings → Apps.
- Generate a token under "API Token".
- 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.
Reduce context noise by limiting available tools. Add this to your env configuration:
"ENABLED_TOOLS": "create_task,get_task,update_task,get_workspace_hierarchy"👇 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 for parameters and advanced usage.
This server supports STDIO, HTTP Streamable, and SSE (Server-Sent Events) for legacy integrations.
Configuration:
{
"env": {
"ENABLE_SSE": "true",
"PORT": "3231"
}
}n8n Setup:
- Set
ENABLE_SSEto "true" and run the server. - In n8n, add an "MCP AI Tool" node.
- Set Transport to
SSEand URL tohttp://localhost:3231/sse.
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.
This project is an independent work and is not officially associated with or sponsored by ClickUp.
