Harvest Automation

Harvest Automatisierung

Automatisieren Sie Ihre Harvest-Zeiterfassungsvorgänge direkt aus Claude Code. Erfassen Sie Zeiteinträge, verwalten Sie Projekte und Kunden, erstellen Sie Aufgaben und ziehen Sie Berichtsdaten – ganz ohne Ihr Terminal zu verlassen.

Toolkit-Dokumentation: composio.dev/toolkits/harvest

---

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 sich bei Aufforderung über den bereitgestellten Verbindungslink mit Ihrem Harvest-Konto
3. Beginnen Sie mit der Automatisierung Ihrer Zeiterfassungs-Workflows mit natürlicher Sprache

---

Kern-Workflows

1. Zeiteinträge erfassen und verwalten

Erstellen, listen, aktualisieren und abrufen Sie Zeiteinträge für genaue Abrechnung und Berichterstattung.

Werkzeuge: HARVEST_CREATE_TIME_ENTRY, HARVEST_LIST_TIME_ENTRIES, HARVEST_GET_TIME_ENTRY, HARVEST_UPDATE_TIME_ENTRY

Erfasse 3,5 Stunden Entwicklungsarbeit an Projekt 12345, Aufgabe 67890 für heute

Wichtige Parameter für HARVEST_CREATE_TIME_ENTRY:

• project_id (erforderlich) – das Projekt, für das gebucht werden soll
• task_id (erforderlich) – die Aufgabe muss dem Projekt zugeordnet sein
• spent_date (erforderlich) – Datum im Format YYYY-MM-DD
• hours – Gesamtstunden (für dauerbasierte Konten)
• started_time / ended_time – für zeitstempelbasierte Konten
• notes – Beschreibung der durchgeführten Arbeit

Wichtige Parameter für HARVEST_LIST_TIME_ENTRIES:

• from_date / to – Datumsbereichsfilter (YYYY-MM-DD)
• project_id, client_id, task_id, user_id – Entitätsfilter
• is_billed / is_running – Statusfilter
• page / per_page (max 2000) – Paginierung

2. Projekte verwalten

Erstellen Sie neue Projekte und listen Sie bestehende mit Kunden- und Abrechnungskonfiguration auf.

Werkzeuge: HARVEST_CREATE_PROJECT, HARVEST_LIST_PROJECTS, HARVEST_GET_PROJECT

Erstelle ein abrechenbares Projekt namens "Webseiten-Neugestaltung" für Kunde 456 mit Aufgabenabrechnung und Projektbudget

Wichtige Parameter für HARVEST_CREATE_PROJECT:

• name, client_id, is_billable, bill_by, budget_by (alle erforderlich)
• bill_by Optionen: "Project", "Tasks", "People", "none"
• budget_by Optionen: "project", "project_cost", "task", "task_fees", "person", "none"
• Optional: budget, hourly_rate, starts_on, ends_on, is_fixed_fee

3. Kunden verwalten

Erstellen und listen Sie Kunden, unter denen Projekte organisiert werden.

Werkzeuge: HARVEST_CREATE_CLIENT, HARVEST_LIST_CLIENTS

Liste alle aktiven Kunden in unserem Harvest-Konto auf

• HARVEST_CREATE_CLIENT erfordert name; akzeptiert address, currency, is_active
• HARVEST_LIST_CLIENTS unterstützt den is_active-Filter und Paginierung (per_page max 2000)

4. Aufgaben verwalten

Erstellen und listen Sie wiederverwendbare Aufgabentypen für die Zeiterfassung.

Werkzeuge: HARVEST_CREATE_TASK, HARVEST_LIST_TASKS

Erstelle eine neue abrechenbare Aufgabe namens "Code-Review" mit einem Standardsatz von 150$/h

• HARVEST_CREATE_TASK erfordert name; akzeptiert billable_by_default, default_hourly_rate, is_active, is_default
• HARVEST_LIST_TASKS unterstützt is_active, is_default-Filter und Paginierung (per_page max 100)
• Aufgabennamen müssen über alle Aufgaben (aktiv und archiviert) hinweg eindeutig sein

5. Zeiteintragsberichte

Rufen Sie Zeiteinträge mit Datumsbereichen und Filtern für Abrechnungszusammenfassungen und Auslastungsberichte ab.

Werkzeuge: HARVEST_LIST_TIME_ENTRIES, HARVEST_GET_TIME_ENTRY

Zeige mir alle nicht abgerechneten Zeiteinträge für Projekt 789 aus Januar 2026

• Verwenden Sie from_date und to für die Datumsfensterung
• Filtern Sie mit is_billed: false für nicht abgerechnete Einträge
• Kombinieren Sie project_id, user_id, client_id für dimensionsübergreifende Berichte
• Paginieren Sie mit page und per_page, um vollständige Datensätze zu sammeln

6. Zeiteinträge aktualisieren und korrigieren

Ändern Sie vorhandene Zeiteinträge, um Stunden zu korrigieren, Projekte neu zuzuweisen oder Notizen zu aktualisieren.

Werkzeuge: HARVEST_UPDATE_TIME_ENTRY

Aktualisiere Zeiteintrag 123456, um die Stunden auf 4,0 zu ändern und die Notiz "API-Integration abgeschlossen" hinzuzufügen

• Erfordert time_entry_id
• Unterstützt Teilaktualisierungen – nur Felder einschließen, die geändert werden sollen
• Kann hours, notes, project_id, task_id, spent_date, started_time, ended_time aktualisieren

---

Bekannte Fallstricke

• Aufgabenzuordnung ist wichtig: Beim Erstellen von Zeiteinträgen muss die task_id einer Aufgabe entsprechen, die tatsächlich dem angegebenen project_id zugeordnet ist. Verwenden Sie den Endpunkt für Projektaufgabenzuordnungen zur Überprüfung, nicht nur HARVEST_LIST_TASKS (der globale Aufgaben zurückgibt).
• Dauer vs. Zeitstempelverfolgung: Harvest-Konten sind entweder für dauerbasierte oder zeitstempelbasierte Verfolgung konfiguriert. hours wird bei Zeitstempelkonten ignoriert; started_time/ended_time werden bei Dauer-Konten ignoriert.
• Paginierungsgrenzen variieren: HARVEST_LIST_TIME_ENTRIES und HARVEST_LIST_CLIENTS unterstützen bis zu 2000 pro Seite, aber HARVEST_LIST_PROJECTS und HARVEST_LIST_TASKS begrenzen auf 100 pro Seite.
• Datumsformat-Konsistenz: Alle Datumsparameter müssen das Format YYYY-MM-DD verwenden. ISO 8601 mit Zeitzone wird für updated_since-Filter verwendet.
• Erforderliche Felder für Projekte: HARVEST_CREATE_PROJECT erfordert fünf Felder: name, client_id, is_billable, bill_by und budget_by. Das Fehlen eines führt zu einem Validierungsfehler.

---

Kurzreferenz

Tool Slug	Beschreibung
HARVEST_LIST_TIME_ENTRIES	Zeiteinträge mit Datums-, Projekt-, Kunden-, Benutzerfiltern auflisten
HARVEST_CREATE_TIME_ENTRY	Neuen Zeiteintrag erfassen (erfordert project_id, task_id, spent_date)
HARVEST_GET_TIME_ENTRY	Bestimmten Zeiteintrag nach ID abrufen
HARVEST_UPDATE_TIME_ENTRY	Vorhandenen Zeiteintrag aktualisieren (erfordert time_entry_id)
HARVEST_LIST_PROJECTS	Projekte mit optionalem Kundenfilter auflisten
HARVEST_CREATE_PROJECT	Neues Projekt mit Abrechnungskonfiguration erstellen
HARVEST_GET_PROJECT	Bestimmtes Projekt nach ID abrufen
HARVEST_LIST_CLIENTS	Kunden mit Aktiv/Inaktiv-Filter auflisten
HARVEST_CREATE_CLIENT	Neuen Kunden erstellen (erfordert name)
HARVEST_LIST_TASKS	Wiederverwendbare Aufgabentypen auflisten
HARVEST_CREATE_TASK	Neuen Aufgabentyp erstellen (erfordert name)

---

Bereitgestellt von Composio