clickup-mcp

Leichtgewichtiger ClickUp-MCP-Server, der auf Aufgabenverwaltung fokussiert ist. 39 Werkzeuge mit token-optimierten Antworten – API-Antworten werden automatisch von Tausenden von Zeichen auf das Wesentliche reduziert.

Warum dieser Server?

Die ClickUp-API liefert extrem ausführliches JSON. Dieser Server reduziert es auf das Wesentliche:

Weniger Tokens = schnellere Antworten, geringere Kosten, mehr Kontext für deine KI.

Related MCP server: ClickUp MCP Server

Installation

npm install -g @cavort-it-systems/clickup-mcp

Oder direkt ausführen:

npx @cavort-it-systems/clickup-mcp

Konfiguration

Claude Code CLI

claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- npx @cavort-it-systems/clickup-mcp

Claude Desktop / Manuell

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["@cavort-it-systems/clickup-mcp"],
      "env": {
        "CLICKUP_API_TOKEN": "your-token"
      }
    }
  }
}

Aus dem Quellcode

git clone https://github.com/cvrt-jh/clickup-mcp.git
cd clickup-mcp
npm install && npm run build

Dann konfiguriere mit dem Build-Pfad:

claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- node /path/to/clickup-mcp/build/index.js

API-Token abrufen

1. Gehe zu den ClickUp-Einstellungen > Apps

2. Generiere einen persönlichen API-Token

3. Setze ihn als CLICKUP_API_TOKEN

Antwortverschlankung

Alle Antworten werden automatisch gekürzt, um Tokens zu sparen. Die ClickUp-API liefert extrem ausführliches JSON – dieser Server reduziert es auf das Wesentliche.

clickup_whoami - von ~3.500 Zeichen auf ~160:

// Before (ClickUp API raw)
{"user":{"id":12345678,"username":"Jane Doe","email":"jane@example.com","color":"#0388d1",
"profilePicture":"https://attachments.clickup.com/...","initials":"JD",
"week_start_day":1,"global_font_support":true,"timezone":"Europe/Berlin"},
"teams":{"teams":[{"id":"99999999","name":"My Workspace","color":"#40BC86",
"avatar":"https://attachments2.clickup.com/...?Expires=...&Key-Pair-Id=...&Signature=...",
"members":[{"user":{"id":11111111,"username":"Bob Smith","email":"bob@example.com",
"color":"#aa2fff","profilePicture":null,"initials":"BS","role":4,"role_subtype":2,
"role_key":"guest","custom_role":null,"last_active":"...","date_joined":"...",
"date_invited":"..."},"invited_by":{"id":22222222,...},
"can_see_time_spent":true,...}, ...]}]}}

// After (slimmed)
{"id":12345678,"username":"Jane Doe","email":"jane@example.com",
"timezone":"Europe/Berlin","workspaces":[{"id":"99999999",
"name":"My Workspace","member_count":4}]}

clickup_create_comment - von ~1.500 Zeichen auf 38:

// Before
{"id":90150191300876,"hist_id":"...","date":1770053982842,
"version":{"object_type":"comment","object_id":"...","workspace_id":99999999,
"operation":"c","data":{"context":{"root_parent_type":1,"is_chat":false,
"audit_context":{"userid":12345678,"current_time":...,"route":"*"},...},...},...}}

// After
{"id":90150191300876,"date":1770053982842}

Was entfernt wird:

Werkzeuge (37)

Navigation (7)

• clickup_whoami - Aktueller Benutzer + Workspaces

• clickup_get_spaces - Spaces im Workspace

• clickup_get_folders - Ordner im Space

• clickup_get_lists - Listen in Ordner oder Space

• clickup_get_list - Details einer einzelnen Liste

• clickup_create_list - Liste in Ordner oder Space erstellen

• clickup_delete_list - Liste löschen (endgültig)

Aufgaben-CRUD (5)

• clickup_get_task - Aufgabe anhand der ID abrufen

• clickup_create_task - Aufgabe mit allen Feldern erstellen

• clickup_update_task - Beliebiges Aufgabenfeld aktualisieren

• clickup_get_tasks - Aufgaben in einer Liste auflisten

• clickup_search_tasks - Aufgaben im gesamten Workspace suchen

Benutzerdefinierte Felder (1)

• clickup_set_custom_field - Wert des benutzerdefinierten Felds setzen

Tags (6)

• clickup_get_space_tags - Space-Tags auflisten

• clickup_create_space_tag - Tag erstellen

• clickup_edit_space_tag - Tag bearbeiten

• clickup_delete_space_tag - Tag löschen

• clickup_add_tag_to_task - Aufgabe taggen

• clickup_remove_tag_from_task - Tag von Aufgabe entfernen

Checklisten (6)

• clickup_create_checklist - Checkliste erstellen

• clickup_edit_checklist - Checkliste bearbeiten

• clickup_delete_checklist - Checkliste löschen

• clickup_create_checklist_item - Element hinzufügen

• clickup_edit_checklist_item - Element bearbeiten

• clickup_delete_checklist_item - Element löschen

Abhängigkeiten (4)

• clickup_add_dependency - Abhängigkeit hinzufügen

• clickup_delete_dependency - Abhängigkeit entfernen

• clickup_add_task_link - Aufgaben verknüpfen

• clickup_delete_task_link - Aufgabenverknüpfung aufheben

Kommentare (5)

• clickup_create_comment - Kommentar hinzufügen

• clickup_get_comments - Kommentare abrufen

• clickup_update_comment - Kommentar bearbeiten/auflösen

• clickup_create_reply - Thread-Antwort

• clickup_get_replies - Antworten abrufen

Aufgabe löschen (1)

• clickup_delete_task - Aufgabe löschen

Multi-Listen-Mitgliedschaft (2)

• clickup_add_task_to_list - Aufgabe zu einer zusätzlichen Liste hinzufügen (Multi-Homing)

• clickup_remove_task_from_list - Aufgabe aus einer zusätzlichen Liste entfernen

Diese verschieben eine Aufgabe nicht. Die ClickUp-v2-API hat keinen Endpunkt zum Verschieben zwischen Listen. Verifiziert gegen die Live-API am 2026-08-12: POST /list/{list}/task/{task} fügt einen sekundären Speicherort hinzu und lässt die Heimatliste unverändert, während eine list_id in PUT /task/{id} HTTP 200 zurückgibt und stillschweigend ignoriert wird. Um eine Aufgabe wirklich zu verschieben und ihre benutzerdefinierte ID und den Verlauf zu behalten, verwende die ClickUp-Weboberfläche (Rechtsklick -> Verschieben). Die Mitgliedschaft in mehreren Listen erfordert außerdem das kostenpflichtige Feature „Tasks-in-Multiple-Lists“.

Workspace-Mitglieder (2)

• clickup_get_workspace_members - Alle Workspace-Mitglieder

• clickup_get_list_members - Listenspezifische Mitglieder

Architektur

src/
  index.ts          # Entry: McpServer + StdioServerTransport
  client.ts         # ClickUp API v2 fetch wrapper
  types.ts          # Shared Zod schemas + jsonResult helper
  slim.ts           # Response slimming transformers
  tools/
    navigation.ts   # 7 tools
    tasks.ts        # 9 tools (CRUD + custom fields + delete + multi-list)
    tags.ts         # 6 tools
    checklists.ts   # 6 tools
    dependencies.ts # 4 tools
    comments.ts     # 5 tools
    members.ts      # 2 tools

Lizenz

MIT