ClickUp MCP (Streamable HTTP)

MCP-Server für die ClickUp REST API mit:

• Arbeitsbereichsweite Aufgabensuche (GET /team/{team_id}/task)

• Aufgaben-CRUD (+ Unteraufgaben)

• Grundlegendes Browsing (Teams, Bereiche, Ordner, Listen)

• Helfer für kürzliche Aktivitäten (via date_updated_gt, sowie Audit-Logs, falls verfügbar)

• Dokumente-CRUD/Suche (v3 API): Suchen, Abrufen, Erstellen von Dokumenten und Seiten

• Escape-Hatch: Generisches Tool zum Aufrufen jedes ClickUp API-Endpunkts (v2 und v3).

Dieser Server ist für den Betrieb als Docker-Dienst vorgesehen und kann von OpenWebUI und LibreChat genutzt werden.

Umgebung

• CLICKUP_API_TOKEN (erforderlich)

• CLICKUP_TEAM_ID (optional, erkennt automatisch das erste Team, falls nicht gesetzt)

• CLICKUP_WORKSPACE_ID (optional; ClickUp nennt dies in v2 oft "team_id")

• CLICKUP_API_BASE_URL (optional, Standard https://api.clickup.com/api/v2)

• CLICKUP_API_V3_BASE_URL (optional, Standard https://api.clickup.com/api/v3)

Ausführung (lokal)

python -m clickup_mcp --transport streamable-http --host 0.0.0.0 --port 8000 --path /mcp

OpenWebUI sollte sich verbinden mit: http://clickup-mcp:8000/mcp

Tools

Aufgaben (v2 API)

• search_tasks - Aufgaben nach Name/Beschreibung suchen

• filter_tasks - Aufgaben nach Metadaten filtern (Status, Bearbeiter, Daten, etc.)

• get_task - Eine Aufgabe anhand der ID abrufen

• create_task - Eine neue Aufgabe erstellen

• create_subtask - Eine Unteraufgabe unter einer bestehenden Aufgabe erstellen

• update_task - Eine Aufgabe aktualisieren

• delete_task - Eine Aufgabe löschen

• get_task_comments - Kommentare für eine Aufgabe abrufen

• create_task_comment - Einen Kommentar zu einer Aufgabe erstellen

Browsing (v2 API)

• clickup_context - Aufgelösten Kontext abrufen (Team/Arbeitsbereich-ID und aktueller Benutzer)

• list_teams - ClickUp-Teams/Arbeitsbereiche auflisten

• get_team - Ein Team anhand der ID abrufen

• list_spaces - Bereiche in einem Team auflisten

• list_folders - Ordner in einem Bereich auflisten

• list_lists_in_space - (Ordnerlose) Listen in einem Bereich auflisten

• list_lists_in_folder - Listen in einem Ordner auflisten

• list_tasks_in_list - Aufgaben in einer Liste auflisten

Dokumente (v3 API)

• search_docs - Alle Dokumente im Arbeitsbereich suchen/auflisten

• get_doc - Ein Dokument anhand der ID abrufen (enthält Seitenliste)

• create_doc - Ein neues Dokument erstellen

Seiten (v3 API)

• list_doc_pages - Alle Seiten in einem Dokument auflisten

• get_doc_page_listing - Hierarchische Seitenstruktur für ein Dokument abrufen

• get_doc_page - Eine bestimmte Seite abrufen (mit Inhalt)

• create_doc_page - Eine neue Seite in einem Dokument erstellen

• update_doc_page - Eine Seite aktualisieren/bearbeiten (Inhalt ersetzen, anhängen oder voranstellen)

Dienstprogramme

• recent_activity - Kürzliche Aktivitäten abrufen (Audit-Logs oder kürzlich aktualisierte Aufgaben)

• clickup_api_request - Generischer v2 API Escape-Hatch

• clickup_v3_api_request - Generischer v3 API Escape-Hatch

• health - Gesundheitsprüfung