Clockify MCP

Clockify MCP-Server

Dieser MCP-Server ermöglicht LLMs (wie Cursor oder Claude) die Interaktion mit Ihrem Clockify-Arbeitsbereich und ermöglicht so erweiterte Automatisierung und Berichterstattung der Zeiterfassung. Mit diesem Server können Sie:

• Listen Sie alle Projekte in Ihrem Arbeitsbereich auf
• Listen Sie alle Benutzer in Ihrem Arbeitsbereich auf
• Zeiteinträge für sich selbst oder einen beliebigen Benutzer hinzufügen und nachschlagen (sofern Sie über die entsprechenden Berechtigungen verfügen)
• Rufen Sie die Arbeitszeitnachweise aller Benutzer aus allen Projekten ab
• Erstellen Sie mithilfe der Clockify-API für zusammenfassende Berichte monatliche oder benutzerdefinierte Zeitbereichsaufschlüsselungen der Stunden nach Benutzer und Projekt.
• Integrieren Sie LLMs, um Ihre Zeiterfassungsdaten zu automatisieren, zusammenzufassen oder zu analysieren

Merkmale

• listProjects: Listet alle Projekte für den authentifizierten Benutzer auf
• getTimeEntries: Listet Zeiteinträge für den authentifizierten Benutzer auf (mit optionalen Datumsfiltern)
• addTimeEntry: Zeiteinträge zu einem Projekt hinzufügen
• listUsers: Listet alle Benutzer im Arbeitsbereich auf
• getUserTimeEntries: Listet Zeiteinträge für jeden Benutzer auf (mit optionalen Datumsfiltern)
• getSummaryReport: Erhalten Sie einen zusammenfassenden Stundenbericht nach Benutzer/Projekt für einen bestimmten Zeitraum (optional gefiltert nach Benutzer-IDs/Projekt-IDs). Ermöglicht monatliche/stündliche Aufschlüsselungen für jeden Benutzer oder jedes Projekt.

Schnellstart (Docker – bevorzugt)

MCP-Serverkonfiguration für Cursor/Claude

Fügen Sie Folgendes zu Ihrer Cursor- oder Claude- settings.json hinzu (ersetzen Sie YOUR_API_KEY ):

So erhalten Sie einen Clockify-API-Schlüssel

1. Melden Sie sich bei Ihrem Clockify-Konto an.
2. Klicken Sie auf Ihr Profilsymbol (oben rechts) und wählen Sie Profil aus.
3. Scrollen Sie nach unten zum API- Abschnitt.
4. Klicken Sie auf „Generieren“ , wenn Sie keinen API-Schlüssel haben, oder kopieren Sie Ihren vorhandenen Schlüssel.

Mitwirken und CI/CD

Dieses Projekt verwendet GitHub Actions, um das Docker-Image bei jedem Push an main automatisch zu erstellen und im GitHub Container Registry (GHCR) zu veröffentlichen.

• Bild-URL: ghcr.io/inakianduaga/clockify-mcp:latest
• So ziehen Sie das Bild:
  docker pull ghcr.io/inakianduaga/clockify-mcp:latest

Sie können veröffentlichte Bilder im Abschnitt „Pakete“ Ihres GitHub-Profils oder -Repositorys anzeigen.

Speicherbank und Optimierungen

Die Entwicklung erfolgte mithilfe von Cursorn und optimierten Regeln. Siehe: https://github.com/Bhartendu-Kumar/rules\_template

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Weitere Informationen finden Sie in der Datei LICENSE .