ClickUp MCP Server

A Model Context Protocol (MCP) server providing AI assistants with comprehensive ClickUp integration. 87 registered tools covering the equivalent of 173 granular operations.

Why consolidated tools?

Most MCP servers register one tool per API endpoint. This fork uses 18 consolidated multi-action tools that accept an action parameter to pack 3–12 related operations into a single registration. The LLM picks action: "list" | "create" | "set_filters" instead of scanning a dozen separate tool names.

The result is 87 tools covering what would be 173 separate operations — each consolidated tool averaging 6 operations per registration.

By the numbers

Related MCP server: ClickUp MCP Server

Features

• Full ClickUp API surface — tasks, lists, docs, chat, goals, webhooks, guests, time tracking, dependencies, custom fields, views, and more

• 18 consolidated multi-action tools covering 104 operations — each handles 3–12 actions under one registration

• Consistent domain_verb naming — tasks_create, lists_search, docs_get. No clickup_ prefix, no scattered verb_noun conventions

• Project intelligence — 8 built-in analysis reports computed from live data (health score, velocity, bottlenecks, workload, risk, sprint readiness, dependency chains, time reports)

• Webhook receiver — standalone HTTP server with HMAC-256 validation for real-time event processing

• No rate limits — personal API key auth, no daily cap

• MIT licensed — all source included, no premium tiers

Quick Start

npm install clickup-mcp-server

Add to your MCP client configuration:

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["-y", "clickup-mcp-server"],
      "env": {
        "CLICKUP_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Get your API token from ClickUp Settings → Apps → API Token.

Tools

Standard tools (one operation each)

Consolidated tools (multi-action via action param)

Project Intelligence

The project_intelligence tool computes structured metrics from live ClickUp data in a single call per report:

• health — status distribution, health score (0–100), letter grade, blocked/overdue/stale rates

• bottlenecks — per-status dwell time, stalled tasks, top bottleneck identification

• velocity — completion rate over 7/14/30 days, projection to done, confidence from sample size

• dependencies — transitive chain analysis, critical path, circular dependency detection

• sprint — ready/blocked/in-progress split, capacity score, recommended scope

• workload — per-assignee counts with status breakdown, overload flags, unassigned tasks

• risk — per-task score (0–100) combining blocked + overdue + stale + priority, with distribution

• time_report — aggregated hours per person, per task, per day

Every report handles edge cases: empty lists, missing dates, unassigned tasks, zero completions.

Webhook Receiver (optional)

Process ClickUp webhook events without external infrastructure:

WEBHOOK_PORT=3001 WEBHOOK_SECRET=your_secret npx clickup-mcp-receiver

• HMAC-SHA256 signature validation (constant-time compare, different-length buffer safe)

• Structured event parsing — extracts type, object, operation, changes, user, and timestamp

• Optional forwarding to any callback URL for pipeline integration

• Pure Node.js http module — zero extra dependencies

Development

git clone https://github.com/benthesoundguy/clickup-mcp-server
cd clickup-mcp-server
npm install
npm run build

License

MIT — see LICENSE.