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: @lewinnovation/clockify-mcp-server

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

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 .