Build-Status Docker-Image

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.

Related MCP server: XcodeBuildMCP

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 ):

{ "mcpServers": { "clockify-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "CLOCKIFY_API_KEY=<YOUR_API_KEY>", "ghcr.io/inakianduaga/clockify-mcp:latest" ], "disabled": false, "autoApprove": [] } } }

So erhalten Sie einen Clockify-API-Schlüssel

Melden Sie sich bei Ihrem Clockify-Konto an.
Klicken Sie auf Ihr Profilsymbol (oben rechts) und wählen Sie Profil aus.
Scrollen Sie nach unten zum API- Abschnitt.
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.