Skip to content

taazkareem/clickup-mcp-server

Repository files navigation

ClickUp MCP Server

ClickUp MCP Server Premium Image

npm version npm downloads License Maintained

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


💎 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) 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.


🚀 Quick Start

1. Prerequisites

  • Node.js v18.0.0+
  • License Key: Purchase here
  • ClickUp Credentials: API Key & Team ID

2. Configure MCP Client

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"
      }
    }
  }
}

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:
  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:

"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 for parameters and advanced usage.


🔌 Compatibility

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

Configuration:

{
  "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 in this repository.


Created by taazkareem
This project is an independent work and is not officially associated with or sponsored by ClickUp.