Clockify-Automation

Clockify Automatisierung

Automatisieren Sie Ihre Clockify-Zeiterfassungsvorgänge direkt von Claude Code aus. Zeiteinträge protokollieren, historische Daten abfragen, Arbeitsbereiche verwalten und Teamaktivitäten prüfen – alles ohne die Kommandozeile zu verlassen.

Toolkit-Dokumentation: composio.dev/toolkits/clockify

---

Einrichtung

1. Fügen Sie den Rube MCP-Server mit der URL https://rube.app/mcp in Ihre Claude Code-Konfiguration ein.
2. Authentifizieren Sie sich nach Aufforderung über den bereitgestellten Verbindungslink mit Ihrem Clockify-Konto.
3. Beginnen Sie, Ihre Zeiterfassungs-Workflows mit natürlicher Sprache zu automatisieren.

---

Kern-Workflows

1. Zeiteinträge erstellen

Erfassen Sie Arbeitszeit mit Projekt-, Aufgaben- und Tag-Zuordnung sowie abrechenbarem Status.

Tool: CLOCKIFY_CREATE_TIME_ENTRY

Logge 2 Stunden Arbeit an Projekt 64a687e2 im Arbeitsbereich 64a687e3, beginnend um 9:00 Uhr UTC heute mit Beschreibung "API-Entwicklung"

Wichtige Parameter:

• workspaceId (erforderlich) – Arbeitsbereich, in dem der Eintrag erstellt wird
• start (erforderlich) – ISO 8601 Startzeit (z. B. 2026-02-11T09:00:00Z)
• end – ISO 8601 Endzeit; weglassen, um einen laufenden Timer zu starten
• projectId – mit einem Projekt verknüpfen
• taskId – mit einer Aufgabe verknüpfen
• description – Arbeitsbeschreibung (0-3000 Zeichen)
• tagIds – Array von Tag-IDs
• billable – ob der Eintrag abrechenbar ist
• customFieldValues – Array von benutzerdefinierten Feldeinträgen mit customFieldId und value

2. Zeiteinträge abfragen

Historische Zeiteinträge für Berichte, Prüfungen und Rechnungsstellung abrufen.

Tool: CLOCKIFY_GET_TIME_ENTRIES

Hole alle Zeiteinträge für Benutzer abc123 im Arbeitsbereich xyz789 von Januar 2026

Wichtige Parameter:

• workspaceId (erforderlich) – abzufragender Arbeitsbereich
• userId (erforderlich) – Benutzer, dessen Einträge abgerufen werden
• start / end – ISO 8601 Datumsbereichsfilter
• project – Filter nach Projekt-ID
• task – Filter nach Aufgaben-ID
• tags – Kommagetrennte Tag-IDs
• description – Textfilter (Teilübereinstimmung)
• hydrated – auf true setzen, um vollständige Projekt-/Aufgaben-/Tag-Objekte statt nur IDs zu erhalten
• in-progress – auf true setzen, um nur den laufenden Timer zurückzugeben
• page / page-size – Paginierung (Standard 50 pro Seite)

3. Zeiteinträge löschen

Fehlerhafte, doppelte oder stornierte Zeiteinträge entfernen.

Tool: CLOCKIFY_DELETE_TIME_ENTRY

Lösche Zeiteintrag 5b715448 aus Arbeitsbereich 64a687e3

• Erfordert workspaceId und id (die Zeiteintrags-ID)
• Zur Bereinigung fehlerhafter Importe oder Dubletten verwenden

4. Arbeitsbereiche verwalten

Alle Arbeitsbereiche auflisten, denen der authentifizierte Benutzer angehört.

Tool: CLOCKIFY_GET_ALL_MY_WORKSPACES

Zeige mir alle meine Clockify-Arbeitsbereiche

• Optionaler roles-Filter – Array von Rollen wie ["WORKSPACE_ADMIN", "OWNER"]
• Verwenden Sie dies, um Arbeitsbereichs-IDs zu ermitteln, bevor Sie Einträge erstellen oder abfragen

5. Benutzerinformationen

Aktuelle Benutzerdetails abrufen und Arbeitsbereichsmitglieder auflisten.

Tools: CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO, CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACE

Wer bin ich? Dann liste alle Benutzer im Arbeitsbereich 64a687e3 auf

• CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO gibt das Profil des authentifizierten Benutzers zurück (keine Parameter erforderlich)
• CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACE erfordert workspaceId; unterstützt Filter nach name und email sowie Paginierung (page, page-size max 100)

6. Laufenden Timer verwalten

Starten Sie einen Timer, indem Sie end beim Erstellen weglassen, oder prüfen Sie auf laufende Einträge.

Tools: CLOCKIFY_CREATE_TIME_ENTRY, CLOCKIFY_GET_TIME_ENTRIES

Starte einen Timer für Projekt abc im Arbeitsbereich xyz mit Beschreibung "Arbeite an Bug-Fix"

• Erstellen ohne end, um einen laufenden Timer zu starten
• Verwenden Sie CLOCKIFY_GET_TIME_ENTRIES mit in-progress: true, um zu prüfen, ob ein Timer läuft

---

Bekannte Fallstricke

• Arbeitsbereichs- und Benutzer-IDs sind erforderlich: Die meisten Clockify-Tools benötigen sowohl workspaceId als auch userId. Rufen Sie immer zuerst CLOCKIFY_GET_ALL_MY_WORKSPACES und CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO auf, um diese IDs zu ermitteln.
• ISO 8601-Zeitstempel: Alle Zeitparameter müssen im ISO 8601-Format mit Zeitzone angegeben werden (z. B. 2026-02-11T09:00:00Z). Das Weglassen der Zeitzone führt zu unvorhersehbarem Verhalten.
• Laufende Timer: Es kann immer nur ein Timer gleichzeitig laufen. Das Erstellen eines neuen Eintrags ohne end schlägt fehl, wenn bereits ein anderer Timer aktiv ist. Stoppen Sie zuerst den bestehenden Timer.
• Paginierungsvorgaben: CLOCKIFY_GET_TIME_ENTRIES liefert standardmäßig 50 Einträge pro Seite. Für vollständige Exporte durchlaufen Sie die Seiten, bis keine weiteren Ergebnisse mehr zurückgegeben werden.
• Tag-IDs sind arbeitsbereichsspezifisch: Tag-IDs aus einem Arbeitsbereich können nicht in einem anderen verwendet werden. Lösen Sie Tags immer im Kontext des Zielarbeitsbereichs auf.

---

Kurzreferenz

Tool-Slug	Beschreibung
CLOCKIFY_CREATE_TIME_ENTRY	Zeiteintrag erstellen oder Timer starten (erfordert workspaceId, start)
CLOCKIFY_GET_TIME_ENTRIES	Zeiteinträge mit Filtern auflisten (erfordert workspaceId, userId)
CLOCKIFY_DELETE_TIME_ENTRY	Zeiteintrag löschen (erfordert workspaceId, id)
CLOCKIFY_GET_ALL_MY_WORKSPACES	Alle Arbeitsbereiche des authentifizierten Benutzers auflisten
CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO	Aktuelles Benutzerprofil abrufen
CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACE	Alle Benutzer in einem Arbeitsbereich auflisten (erfordert workspaceId)

---

Bereitgestellt von Composio