ComposioHQ/Toggl-Automation

Was macht Toggl-Automation?

Automatisieren Sie Ihre Toggl-Track-Arbeitszeiterfassung direkt aus Claude Code. Erfassen Sie Zeit, verwalten Sie Projekte und Kunden, organisieren Sie mit Tags und steuern Sie Arbeitsbereiche – alles ohne die Kommandozeile zu verlassen.

Toolkit-Dokumentation: composio.dev/toolkits/toggl

---

Einrichtung

1. Fügen Sie den Rube MCP-Server zu Ihrer Claude-Code-Konfiguration mit der URL https://rube.app/mcp hinzu.
2. Authentifizieren Sie bei Aufforderung Ihr Toggl-Track-Konto über den bereitgestellten Verbindungslink.
3. Starten Sie die Automatisierung Ihrer Arbeitszeiterfassungs-Workflows mit natürlicher Sprache.

---

Kern-Workflows

1. Zeiteinträge erstellen und stoppen

Erfassen Sie Zeit mit Projekt-, Aufgaben- und Tag-Verknüpfungen oder starten/stoppen Sie Timer.

Tools: TOGGL_CREATE_TIME_ENTRY, TOGGL_PATCH_STOP_TIME_ENTRY

Starte einen Zeiteintrag im Arbeitsbereich 123456 für Projekt 78910, getaggt mit „meeting" und „design", mit der Beschreibung „Design-Review-Sitzung"

Wichtige Parameter für TOGGL_CREATE_TIME_ENTRY:

• workspace_id (erforderlich) – Zielarbeitsbereich
• created_with (erforderlich) – Name der Client-Anwendung (z.B. "api_client")
• start (erforderlich) – ISO-8601-Zeitstempel
• stop – ISO-8601-Endzeit; weglassen, um den Eintrag laufen zu lassen
• duration – Dauer in Sekunden; weglassen für laufende Einträge
• project_id – mit einem Projekt verknüpfen
• task_id – mit einer Aufgabe verknüpfen
• tags – Array von Tag-Namen (keine IDs)
• description – Beschreibung der Arbeit
• billable – abrechenbarer Status

Wichtige Parameter für TOGGL_PATCH_STOP_TIME_ENTRY:

• workspace_id (erforderlich) und time_entry_id (erforderlich)

2. Projekte verwalten

Erstellen Sie neue Projekte und listen Sie bestehende mit Kundendaten und Paginierung auf.

Tools: TOGGL_CREATE_PROJECT, TOGGL_GET_PROJECTS, TOGGL_GET_PROJECT_DETAILS

Erstelle ein privates, abrechenbares Projekt namens „Q1 Marketing Campaign" im Arbeitsbereich 123456 für Kunde 78910

Wichtige Parameter für TOGGL_CREATE_PROJECT:

• workspace_id (erforderlich) und name (erforderlich)
• client_id, billable, is_private, active, color
• estimated_hours, rate, fixed_fee, currency (Premium-Funktionen)

Wichtige Parameter für TOGGL_GET_PROJECTS:

• workspace_id (erforderlich)
• page / page_size (1-200) für Paginierung
• since / until – Unix-Zeitstempel zur Änderungsfilterung (nur letzte 3 Monate)
• clients: true um vollständige Kundendaten einzuschließen

3. Kunden verwalten

Erstellen und listen Sie Kunden innerhalb eines Arbeitsbereichs.

Tools: TOGGL_CREATE_CLIENT, TOGGL_GET_LIST_CLIENTS

Liste alle aktiven Kunden im Arbeitsbereich 123456 auf, erstelle dann einen neuen Kunden namens „Acme Corp"

• TOGGL_CREATE_CLIENT erfordert workspace_id und name; akzeptiert notes, external_reference
• TOGGL_GET_LIST_CLIENTS erfordert workspace_id; unterstützt status ("active", "archived", "both") und name (Groß-/Kleinschreibung-unabhängige Suche)

4. Tags und Arbeitsbereichs-Präferenzen

Rufen Sie Tags zur Kategorisierung ab und prüfen Sie Arbeitsbereichseinstellungen.

Tools: TOGGL_GET_TAGS, TOGGL_GET_WORKSPACE_PREFERENCES

Zeige mir alle Tags im Arbeitsbereich 123456 und die Arbeitsbereichs-Präferenzen

• TOGGL_GET_TAGS erfordert workspace_id; gibt Tag-IDs und -Namen zurück
• TOGGL_GET_WORKSPACE_PREFERENCES erfordert workspace_id; gibt Preisplan und Anzeigeeinstellungen zurück

5. Arbeitsbereiche entdecken

Listen Sie alle Arbeitsbereiche auf, zu denen der authentifizierte Benutzer gehört.

Tool: TOGGL_GET_USER_WORKSPACES

Auf welche Toggl-Arbeitsbereiche habe ich Zugriff?

• Keine Parameter erforderlich
• Gibt alle Arbeitsbereiche mit IDs, Namen und Metadaten zurück
• Verwenden Sie dies zuerst, um Arbeitsbereichs-IDs für andere Operationen zu ermitteln

6. Projekt-Sichtbarkeit des Benutzers

Listen Sie Projekte auf, die für den authentifizierten Benutzer sichtbar sind.

Tool: TOGGL_GET_USER_PROJECTS

Zeige mir alle Projekte, die ich in meinen Arbeitsbereichen sehen kann

• Gibt Projekte zurück, auf die der authentifizierte Benutzer Zugriff hat
• Verwenden Sie dies zusammen mit TOGGL_GET_PROJECTS für arbeitsbereichsbezogene Ansichten

---

Bekannte Fallstricke

• Tags verwenden Namen, keine IDs: TOGGL_CREATE_TIME_ENTRY akzeptiert Tag-Namen als Zeichenketten im tags-Array, anders als viele APIs, die IDs verwenden. Verwenden Sie TOGGL_GET_TAGS, um verfügbare Tag-Namen zu überprüfen.
• created_with ist erforderlich: Jeder Zeiteintrag muss created_with enthalten (z.B. "api_client"). Fehlt dieses Feld, führt dies zu stillen Fehlern.
• Dauer ist in Sekunden: Der Parameter duration bei Zeiteinträgen ist in Sekunden, nicht in Stunden. 1 Stunde = 3600 Sekunden.
• since-Zeitstempel-Einschränkung: Der since-Filter bei TOGGL_GET_PROJECTS erlaubt nur Zeitstempel innerhalb der letzten 3 Monate. Ältere Abfragen werden abgelehnt.
• Premium-Funktionen gesperrt: Benutzerdefinierte Farben, Vorlagen, Pauschalgebühren und Stundensätze für Projekte erfordern einen Premium-Toggl-Plan. Nicht-Premium-Konten erhalten Fehler bei Verwendung dieser Felder.
• Arbeitsbereichs-ID fast überall erforderlich: Nahezu alle Toggl-Tools erfordern workspace_id. Rufen Sie immer zuerst TOGGL_GET_USER_WORKSPACES auf, um diese zu ermitteln.

---

Kurzübersicht

Tool Slug	Beschreibung
TOGGL_CREATE_TIME_ENTRY	Erstellt einen Zeiteintrag oder laufenden Timer (erfordert workspace_id, created_with, start)
TOGGL_PATCH_STOP_TIME_ENTRY	Stoppt einen laufenden Zeiteintrag (erfordert workspace_id, time_entry_id)
TOGGL_GET_PROJECTS	Listet Projekte in einem Arbeitsbereich mit Paginierung
TOGGL_GET_PROJECT_DETAILS	Ruft Details zu einem bestimmten Projekt ab
TOGGL_CREATE_PROJECT	Erstellt ein neues Projekt (erfordert workspace_id, name)
TOGGL_GET_LIST_CLIENTS	Listet Kunden mit Status-/Namen-Filtern (erfordert workspace_id)
TOGGL_CREATE_CLIENT	Erstellt einen neuen Kunden (erfordert workspace_id, name)
TOGGL_GET_TAGS	Listet alle Tags in einem Arbeitsbereich (erfordert workspace_id)
TOGGL_GET_WORKSPACE_PREFERENCES	Ruft Arbeitsbereichseinstellungen ab (erfordert workspace_id)
TOGGL_GET_USER_WORKSPACES	Listet alle Arbeitsbereiche des authentifizierten Benutzers
TOGGL_GET_USER_PROJECTS	Listet Projekte, die für den authentifizierten Benutzer sichtbar sind

---

Unterstützt von Composio