A
securityA
licenseA
qualityThis server integrates AI assistants with ClickUp workspaces, enabling task, team, list, and board management through a secure OAuth2 authentication process.
Last updated -
14
14
MIT License
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.
Ausführen mit SSE-Unterstützung
Der Server kann im SSE-Modus (Server-Sent Events) ausgeführt werden, indem die folgenden Umgebungsvariablen festgelegt werden:
{
"mcpServers": {
"ClickUp": {
"command": "npx",
"args": [
"-y",
"@taazkareem/clickup-mcp-server@latest"
],
"env": {
"CLICKUP_API_KEY": "your-api-key",
"CLICKUP_TEAM_ID": "your-team-id",
"ENABLE_SSE": "true",
"PORT": "8000" // Optional, defaults to 3231
}
}
}
}
Oder über die Kommandozeile:
npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id --env ENABLE_SSE=true --env PORT=8000
Docker-Compose-Beispiel
version: '3.8'
services:
clickup-mcp-server:
build:
context: .
dockerfile: Dockerfile
ports:
- '3231:8000'
environment:
- CLICKUP_API_KEY=${CLICKUP_API_KEY}
- CLICKUP_TEAM_ID=${CLICKUP_TEAM_ID}
- ENABLE_SSE=true
- LOG_LEVEL=info
- DOCUMENT_SUPPORT=true
volumes:
- ./src:/app/src
restart: unless-stopped
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8000/health"]
interval: 30s
timeout: 10s
retries: 3
start_period: 5s
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 | 👥 Mitgliederverwaltung |
• Dokumentenauflistung im gesamten Arbeitsbereich • Dokumentenseitenauflistung • Dokumentenseitendetails • Dokumenterstellung • Dokumentenseitenaktualisierung (Anhängen und Voranstellen) | • Suchen Sie nach Arbeitsbereichsmitgliedern nach Name oder E-Mail• Bestimmen Sie Aufgabenverantwortliche• Zeigen Sie Mitgliederdetails und Berechtigungen an• Weisen Sie Benutzern Aufgaben während der Erstellung zu• Unterstützung für Benutzer-IDs, E-Mails oder Benutzernamen• Teamweite Benutzerverwaltung |
⚡ Integrationsfunktionen | |
• 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 |
Arbeitsbereichsstruktur abrufen | Keiner | |
Erstellen einer Aufgabe |
, (
ID/
) | |
Mehrere Aufgaben erstellen |
| |
Aufgabe ändern |
/
| |
Mehrere Aufgaben aktualisieren |
mit IDs oder Namen | |
Aufgaben aus der Liste abrufen |
ID /
| |
Abrufen einzelner Aufgabendetails |
/
(mit intelligenter Disambiguierung) | |
Aufgaben mit Filterung abrufen | Mindestens ein Filter (Tags, Listen-IDs, Space-IDs usw.) | |
Kommentare zu einer Aufgabe abrufen |
/
| |
Einen Kommentar zu einer Aufgabe hinzufügen |
, (
/ (
+
)) | |
Datei an eine Aufgabe anhängen |
/
, (
oder
) | |
Aufgabe entfernen |
/
| |
Mehrere Aufgaben entfernen |
mit IDs oder Namen | |
Aufgabe verschieben |
-ID / Task
Name,
ID /
| |
Mehrere Aufgaben verschieben |
mit IDs oder Namen, Zielliste | |
Aufgabe kopieren |
-ID / Task
Name,
ID /
| |
Liste im Raum erstellen |
,
/
| |
Ordner erstellen |
,
/
| |
Liste im Ordner erstellen |
,
/
| |
Ordnerdetails abrufen |
/
| |
Ordnereigenschaften aktualisieren |
/
| |
Ordner löschen |
/
| |
Listendetails abrufen |
ID /
| |
Aktualisieren der Listeneigenschaften |
ID /
| |
Liste löschen |
ID /
| |
Holen Sie sich Space-Tags |
/
| |
Tag erstellen |
,
/
| |
Tag aktualisieren |
,
/
| |
Tag löschen |
,
/
| |
Tag zur Aufgabe hinzufügen |
,
/(
+
) | |
Tag aus Aufgabe entfernen |
,
/(
+
) | |
Zeiteinträge für eine Aufgabe abrufen |
/
| |
Starten Sie die Zeiterfassung für eine Aufgabe |
/
| |
Aktuelle Zeiterfassung beenden | Keiner | |
Manuellen Zeiteintrag zu einer Aufgabe hinzufügen |
ID/
,
,
| |
Löschen eines Zeiteintrags |
| |
Holen Sie sich den aktuell laufenden Timer | Keiner | |
Alle Arbeitsbereichsmitglieder abrufen | Keiner | |
Suchen Sie nach Mitgliedern nach Namen oder E-Mail |
| |
Mitgliedsnamen in IDs auflösen |
| |
Erstellen eines Dokuments |
,
,
/
,
,
| |
Ein Dokument erhalten |
/
| |
Dokumente auflisten |
,
/
/
/
/
/
/
/
| |
Dokumentseiten auflisten |
-ID /
| |
Dokumentseiten abrufen |
/
,
| |
Erstellen einer Dokumentseite |
/
,
/
/
,
/
| |
Aktualisieren einer Dokumentseite |
/
ID,
/
,
/
/
|
Informationen zu optionalen Parametern und erweiterter Verwendung finden Sie in der vollständigen Dokumentation .
Tools zur Mitgliederverwaltung
Beim Erstellen von Aufgaben können Sie nun Benutzer mithilfe des Parameters assignees zuweisen. Der Parameter akzeptiert ein Array von Benutzer-IDs, E-Mails oder Benutzernamen:
{
"name": "New Task",
"description": "This is a new task.",
"assignees": ["jdoe@example.com", "Jane Smith"] // Emails, usernames, or user IDs
}
Die Tools zur Mitgliederverwaltung helfen bei Bedarf beim Auflösen von Benutzerreferenzen.
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übersicht | Statusübersicht, Prioritäten, Beziehungen | |
Prioritätsoptimierung | Verteilungsanalyse, Sequenzierung | |
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.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Ermöglicht KI-Integrationen mit ClickUp-Aufgaben und unterstützt Ressourcenverwaltung, Aufgabenvorgänge, Arbeitsbereichsorganisation und KI-gestützte Aufgabenempfehlungen über ein standardisiertes Protokoll.
- Smithery-Installation (Schnellstart)
- NPX-Installation
- Ausführen mit SSE-Unterstützung
- Docker-Compose-Beispiel
- Merkmale
- Verfügbare Tools
- Tools zur Mitgliederverwaltung
- Eingabeaufforderungen
- Fehlerbehandlung
- Unterstützen Sie den Entwickler
- Danksagung
- Beitragen
- Lizenz
- Haftungsausschluss
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityAn enhanced Model Context Protocol server that enables AI assistants to interact with ClickUp workspaces, supporting task relationships, comments, checklists, and workspace management through natural language.Last updated -02MIT License
- -securityAlicense-qualityA Model Context Protocol server that enables AI agents to interact with ClickUp workspaces, allowing task creation, management, and workspace organization through natural language commands.Last updated -1,7032MIT License
- AsecurityAlicenseAqualityEnables AI assistants to interact with ClickUp's task management API for core project workflows, supporting operations like task creation, updates, search, assignment, and team analytics through natural language.Last updated -283MIT License
Appeared in Searches
- A method or tool for managing ClickUp task list custom fields with read and write update capabilities
- Automating Task Assignment Based on Priority with Reshuffling Capabilities
- Tools and platforms for task management
- A tool for planning and managing software projects
- A server for software engineers that integrates with Jira and Slack