ClickUp MCP-Server

Ein Model Context Protocol (MCP)-Server zur Integration von ClickUp-Aufgaben in KI-Anwendungen. Dieser Server ermöglicht KI-Agenten die Interaktion mit ClickUp-Aufgaben, -Bereichen, -Listen und -Ordnern über ein standardisiertes Protokoll.

🚀 Statusaktualisierung: v0.7.2 jetzt mit vollständiger Unterstützung für Zeiterfassung und Dokumentenverwaltungsfunktionen verfügbar.

Aufstellen

Holen Sie sich Ihre Anmeldeinformationen:
- ClickUp-API-Schlüssel aus den ClickUp-Einstellungen
- Team-ID aus Ihrer ClickUp-Arbeitsbereichs-URL
Wählen Sie entweder die gehostete Installation (sendet Webhooks) oder die NPX-Installation (lädt in den lokalen Pfad herunter und installiert Abhängigkeiten).
Verwenden Sie natürliche Sprache, um Ihren Arbeitsbereich zu verwalten!

Smithery-Installation (Schnellstart)

Der Server wird auf Smithery gehostet. Dort können Sie eine Vorschau der verfügbaren Tools anzeigen oder die Befehle kopieren, um sie in Ihrer spezifischen Client-App auszuführen.

NPX-Installation

Fügen Sie diesen Eintrag zur JSON-Datei mit den MCP-Einstellungen Ihres Clients hinzu:

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": [
        "-y",
        "@taazkareem/clickup-mcp-server@latest"
      ],
      "env": {
        "CLICKUP_API_KEY": "your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id",
        "DOCUMENT_SUPPORT": "true"
      }
    }
  }
}

Oder verwenden Sie diesen npx-Befehl:

npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id

Hinweis: Wenn Sie „DOCUMENT_SUPPORT“: „true“ nicht übergeben, ist der Standardwert „false“ und die Dokumentunterstützung wird nicht aktiviert.

Zusätzlich können Sie die Umgebungsvariable DISABLED_TOOLS oder das Argument --env DISABLED_TOOLS verwenden, um bestimmte Tools zu deaktivieren. Geben Sie eine durch Kommas getrennte Liste der zu deaktivierenden Toolnamen an (z. B. create_task,delete_task ).

Bitte deaktivieren Sie Tools, die Sie nicht benötigen, wenn Sie Probleme mit der Anzahl der Tools oder Kontextbeschränkungen haben.

Merkmale

📝 Aufgabenverwaltung	🏷️ Tag-Verwaltung
• Aufgaben erstellen, aktualisieren und löschen• Aufgaben überall verschieben und duplizieren• Unterstützung für Einzel- und Massenvorgänge• Start-/Fälligkeitsdaten in natürlicher Sprache festlegen• Unteraufgaben erstellen und verwalten• Kommentare und Anhänge hinzufügen	• Bereichs-Tags erstellen, aktualisieren und löschen• Tags zu Aufgaben hinzufügen und entfernen• Farbbefehle in natürlicher Sprache verwenden• Automatische kontrastierende Vordergrundfarben• Alle Bereichs-Tags anzeigen• Tag-basierte Aufgabenorganisation im gesamten Arbeitsbereich
⏱️ Zeiterfassung	🌳 Arbeitsplatzorganisation
• Zeiteinträge für Aufgaben anzeigen• Zeiterfassung für Aufgaben starten/stoppen• Manuelle Zeiteinträge hinzufügen• Zeiteinträge löschen• Aktuell laufenden Timer anzeigen• Abrechenbare und nicht abrechenbare Zeit erfassen	• Navigieren Sie durch Bereiche, Ordner und Listen. • Erstellen und Verwalten von Ordnern. • Organisieren Sie Listen in Bereichen. • Erstellen Sie Listen in Ordnern. • Zeigen Sie die Arbeitsbereichshierarchie an. • Effiziente Pfadnavigation.
📄 Dokumentenmanagement	⚡ Integrationsfunktionen
• Dokumentenauflistung im gesamten Arbeitsbereich • Dokumentenseitenauflistung • Dokumentenseitendetails • Dokumenterstellung • Dokumentenseitenaktualisierung (Anhängen und Voranstellen)	• Globale Namens- oder ID-basierte Suchvorgänge• Groß-/Kleinschreibung wird nicht beachtet• Unterstützung für Markdown-Formatierung• Integrierte Ratenbegrenzung• Fehlerbehandlung und -validierung• Umfassende API-Abdeckung

Verfügbare Tools

Werkzeug	Beschreibung	Erforderliche Parameter
get_workspace_hierarchy	Arbeitsbereichsstruktur abrufen	Keiner
Aufgabe erstellen	Erstellen einer Aufgabe	`name` , ( `listId` ID/ `listName` )
Massenaufgaben erstellen	Mehrere Aufgaben erstellen	`tasks[]`
Update-Aufgabe	Aufgabe ändern	`taskId` / `taskName`
Update_Bulk_Tasks	Mehrere Aufgaben aktualisieren	`tasks[]` mit IDs oder Namen
Aufgaben abrufen	Aufgaben aus der Liste abrufen	`listId` ID / `listName`
Aufgabe abrufen	Abrufen einzelner Aufgabendetails	`taskId` / `taskName` (mit intelligenter Disambiguierung)
get_workspace_tasks	Aufgaben mit Filterung abrufen	Mindestens ein Filter (Tags, Listen-IDs, Space-IDs usw.)
get_task_comments	Kommentare zu einer Aufgabe abrufen	`taskId` / `taskName`
Aufgabenkommentar erstellen	Einen Kommentar zu einer Aufgabe hinzufügen	`commentText` , ( `taskId` / ( `taskName` + `listName` ))
Aufgabendatei anhängen	Datei an eine Aufgabe anhängen	`taskId` / `taskName` , ( `file_data` oder `file_url` )
Aufgabe löschen	Aufgabe entfernen	`taskId` / `taskName`
Massenaufgaben löschen	Mehrere Aufgaben entfernen	`tasks[]` mit IDs oder Namen
Aufgabe verschieben	Aufgabe verschieben	`taskId` -ID / Task `taskName` Name, `listId` ID / `listName`
Massenaufgaben verschieben	Mehrere Aufgaben verschieben	`tasks[]` mit IDs oder Namen, Zielliste
doppelte_Aufgabe	Aufgabe kopieren	`taskId` -ID / Task `taskName` Name, `listId` ID / `listName`
Liste erstellen	Liste im Raum erstellen	`name` , `spaceId` / `spaceName`
Ordner erstellen	Ordner erstellen	`name` , `spaceId` / `spaceName`
Liste im Ordner erstellen	Liste im Ordner erstellen	`name` , `folderId` / `folderName`
Ordner abrufen	Ordnerdetails abrufen	`folderId` / `folderName`
Ordner aktualisieren	Ordnereigenschaften aktualisieren	`folderId` / `folderName`
Ordner löschen	Ordner löschen	`folderId` / `folderName`
Liste abrufen	Listendetails abrufen	`listId` ID / `listName`
Updateliste	Aktualisieren der Listeneigenschaften	`listId` ID / `listName`
Löschliste	Liste löschen	`listId` ID / `listName`
get_space_tags	Holen Sie sich Space-Tags	`spaceId` / `spaceName`
create_space_tag	Tag erstellen	`tagName` , `spaceId` / `spaceName`
update_space_tag	Tag aktualisieren	`tagName` , `spaceId` / `spaceName`
delete_space_tag	Tag löschen	`tagName` , `spaceId` / `spaceName`
Tag zur Aufgabe hinzufügen	Tag zur Aufgabe hinzufügen	`tagName` , `taskId` /( `taskName` + `listName` )
Tag aus der Aufgabe entfernen	Tag aus Aufgabe entfernen	`tagName` , `taskId` /( `taskName` + `listName` )
get_task_time_entries	Zeiteinträge für eine Aufgabe abrufen	`taskId` / `taskName`
Startzeiterfassung	Starten Sie die Zeiterfassung für eine Aufgabe	`taskId` / `taskName`
Stoppen Sie die Zeiterfassung	Aktuelle Zeiterfassung beenden	Keiner
add_time_entry	Manuellen Zeiteintrag zu einer Aufgabe hinzufügen	`taskId` ID/ `taskName` , `start` , `duration`
Löschzeiteintrag	Löschen eines Zeiteintrags	`timeEntryId`
get_current_time_entry	Holen Sie sich den aktuell laufenden Timer	Keiner
Dokument erstellen	Erstellen eines Dokuments	`workspaceId` , `name` , `parentId` / `parentType` , `visibility` , `create_pages`
Dokument abrufen	Ein Dokument erhalten	`workspaceId` / `documentId`
Liste_Dokumente	Dokumente auflisten	`workspaceId` , `documentId` / `creator` / `deleted` / `archived` / `parent_id` / `parent_type` / `limit` / `next_cursor`
Liste_Dokumentseiten	Dokumentseiten auflisten	`documentId` -ID / `documentName`
Dokumentseiten abrufen	Dokumentseiten abrufen	`documentId` / `documentName` , `pageIds`
Dokumentseiten erstellen	Erstellen einer Dokumentseite	`workspaceId` / `documentId` , `parent_page_id` / `name` / `sub_title` , `content` / `content_format`
Dokumentseite aktualisieren	Aktualisieren einer Dokumentseite	`workspaceId` / `documentId` ID, `name` / `sub_title` , `content` / `content_edit_mode` / `content_format`

Informationen zu optionalen Parametern und erweiterter Verwendung finden Sie in der vollständigen Dokumentation .

Eingabeaufforderungen

Noch nicht implementiert und wird nicht von allen Client-Apps unterstützt. Fordern Sie eine Funktion für eine Prompt-Implementierung an, die für Ihren Workflow optimal ist (ohne zu spezifisch zu sein). Beispiele:

Prompt	Zweck	Merkmale
Aufgaben zusammenfassen	Aufgabenübersicht	Statusübersicht, Prioritäten, Beziehungen
Prioritäten analysieren	Prioritätsoptimierung	Verteilungsanalyse, Sequenzierung
Beschreibung generieren	Erstellen einer Aufgabenbeschreibung	Ziele, Kriterien, Abhängigkeiten

Fehlerbehandlung

Der Server liefert eindeutige Fehlermeldungen für:

Fehlende erforderliche Parameter
Ungültige IDs oder Namen
Elemente nicht gefunden
Berechtigungsprobleme
API-Fehler
Ratenbegrenzung

Die Umgebungsvariable LOG_LEVEL kann angegeben werden, um den Ausführlichkeitsgrad der Serverprotokolle zu steuern. Gültige Werte sind trace , debug , info , warn und error (Standard). Sie kann auch in der Kommandozeile angegeben werden, z. B. als --env LOG_LEVEL=info .

Unterstützen Sie den Entwickler

Bei der Nutzung dieses Servers wird Ihnen gelegentlich eine kurze Sponsorennachricht mit einem Link zu diesem Repository in den Tool-Antworten angezeigt. Ich hoffe, Sie können das Projekt unterstützen! Wenn Sie dieses Projekt nützlich finden, unterstützen Sie bitte:

Danksagung

Besonderer Dank geht an ClickUp für die hervorragende API und die Dienste, die diese Integration ermöglichen.

Beitragen

Beiträge sind willkommen! Weitere Informationen finden Sie in unserem Leitfaden für Beiträge.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

Haftungsausschluss

Diese Software nutzt APIs von Drittanbietern und kann auf Marken oder Marken von Drittanbietern verweisen. Die Verwendung solcher APIs oder Verweise impliziert keine Zugehörigkeit zu oder Billigung durch die jeweiligen Unternehmen. Alle Marken und Markennamen sind Eigentum ihrer jeweiligen Inhaber. Dieses Projekt ist ein unabhängiges Werk und steht in keiner offiziellen Verbindung zu einem der genannten Drittanbieter oder wird von diesen gesponsert.

ClickUp MCP Server

Integrations

Aufstellen

Smithery-Installation (Schnellstart)

NPX-Installation

Merkmale

Verfügbare Tools

Eingabeaufforderungen

Fehlerbehandlung

Unterstützen Sie den Entwickler

Danksagung

Beitragen

Lizenz

Haftungsausschluss

Tools

Related Resources

Related MCP Servers

ClickUp MCP Server

Browser Automation MCP Server

ClickUp MCP Server

Metabase MCP Server

Appeared in Searches

New MCP Servers