Wer Google Workspace täglich nutzt und gleichzeitig mit Claude Code arbeitet, kennt das Problem: für Drive brauchst du einen API-Client, für Gmail einen anderen, für Sheets wieder ein eigenes SDK. Das Google Workspace CLI löst genau das. Es bündelt alle zentralen Workspace-Dienste in einem Kommandozeilen-Werkzeug, das du direkt aus dem Terminal oder aus Claude-Code-Agenten heraus steuern kannst.
Das Tool stammt aus dem offiziellen Google-Ökosystem. Es wird dynamisch aus dem Google Discovery Service generiert, also direkt aus den offiziellen API-Definitionen aller Workspace-Produkte. Das hält die Befehle aktuell, ohne dass du manuell SDKs aktualisieren musst.
Was ist das Google Workspace CLI?
Das Google Workspace CLI ist ein Open-Source-Werkzeug, das alle zentralen Workspace-Dienste unter einem einheitlichen CLI-Einstiegspunkt zusammenfasst. Du kannst damit Drive-Dateien verwalten, Gmail-Nachrichten senden, Calendar-Termine abfragen und Sheets-Inhalte auslesen sowie schreiben. Dazu kommen Docs und Admin-Operationen, alles über denselben Befehlssatz.
Ein wichtiger Unterschied zu anderen Google-Tools: die Befehle entstehen direkt aus dem Google Discovery Service. Das heißt, sie spiegeln exakt die aktuellen API-Definitionen wider. Wenn Google eine API aktualisiert, folgt das CLI automatisch. Du arbeitest immer auf dem neuesten Stand.
Besonders relevant für Claude-Code-Nutzer: das Tool bringt eingebaute AI-Agent-Skills mit. Du kannst es also nicht nur manuell nutzen, sondern direkt in Agenten-Workflows einbinden. Claude Code führt dann Google-Workspace-Operationen als Teil eines größeren automatisierten Ablaufs aus. Das ist der entscheidende Unterschied zu einem einfachen API-Wrapper.
Das CLI funktioniert außerdem als Erweiterung für Gemini CLI. Wer beide Terminal-KI-Werkzeuge im Einsatz hat, kann damit denselben Workspace-Zugriff in verschiedenen Agenten nutzen. Mehr zu Gemini CLI findest du in unserem Artikel Gemini CLI: Googles KI-Terminal-Agent im Praxis-Check.
Installation und Authentifizierung
Das Repository liegt unter github.com/googleworkspace/cli. Die genauen Installations-Befehle und Voraussetzungen findest du immer aktuell im offiziellen README, da sich CLI-Tooling häufig ändert. Der grundlegende Ablauf ist für Go-basierte Tools typisch:
# Schritt 1: Werkzeug installieren (Syntax im README prüfen)
go install github.com/googleworkspace/cli/cmd/gws@latest
# Schritt 2: Einmalige Authentifizierung via OAuth
gws auth login
# Schritt 3: Erste Abfrage testen
gws drive files list
# Sheets-Inhalt auslesen
gws sheets spreadsheets values get \
--spreadsheetId=DEINE_SHEET_ID \
--range="Tabelle1!A1:D20"
# Gmail-Nachrichten der Inbox auflisten
gws gmail users messages list --userId=me --maxResults=10
Die Authentifizierung läuft über OAuth 2.0. Du wirst beim ersten Start durch einen Browser-Flow geführt. Danach speichert das CLI deine Zugangsdaten lokal. Für CI/CD-Pipelines oder Agenten ohne Browser lassen sich Service-Account-Credentials einrichten. Das macht das Tool auch für vollautomatisierte Abläufe tauglich.
Praxis-Beispiel: Claude Code aktualisiert ein Google Sheet
Stell dir vor, du hast eine Tabelle mit Kundendaten in Google Sheets. Nach jedem Onboarding-Call trägst du Einträge manuell nach. Das kostet Zeit. Mit dem Google Workspace CLI und Claude Code automatisierst du diesen Schritt.
Du gibst Claude Code in deiner CLAUDE.md folgende Anweisung:
## Workspace-Automatisierung
Das Google Workspace CLI (gws) ist installiert und authentifiziert.
Nutze `gws sheets spreadsheets values append` um neue Zeilen
in das Sheet SHEET_ID_HIER einzutragen.
Erwartete Spalten: Datum, Name, E-Mail, Status.
Formatiere das Datum als YYYY-MM-DD.
Dann sagst du Claude Code: "Trag den neuen Kunden Max Müller, max@beispiel.de, Status aktiv ein." Claude Code baut den passenden gws-Befehl, führt ihn aus und bestätigt die Eintragung. Kein Browser, kein manuelles Klicken in Sheets.
Das funktioniert genauso für wiederkehrende Reports: Claude Code liest Daten aus einer Datenbank, transformiert sie und schreibt das Ergebnis direkt in ein Sheet. Oder es liest ein Sheet aus und schreibt darauf basierend Mails via Gmail. Diese Kette aus Lesen, Verarbeiten und Schreiben wird durch die einheitliche CLI-Schnittstelle einfach haltbar.
Die AI-Agent-Skills des Tools gehen noch einen Schritt weiter. Du kannst dem Agenten strukturierte Aufgaben übergeben, die er selbstständig in die richtigen API-Aufrufe übersetzt. Das reduziert den Konfigurationsaufwand auf deiner Seite erheblich.
Wann lohnt sich das Google Workspace CLI?
Das Tool lohnt sich, wenn du mindestens zwei dieser Bedingungen erfüllst. Erstens: Du nutzt Google Workspace täglich als zentrale Arbeitsumgebung. Zweitens: Du willst wiederkehrende Aufgaben automatisieren, etwa Berichte in Sheets eintragen, Mails nach Muster versenden oder Termine anlegen. Drittens: Du arbeitest bereits mit Claude Code und willst Workspace-Operationen in Agenten-Workflows integrieren.
Für gelegentliche Einzel-Aktionen lohnt der Einrichtungsaufwand weniger. Sobald du aber regelmäßig Daten zwischen deinen Systemen und Google Workspace verschiebst, spart das Tool deutlich Zeit pro Woche.
Der größte Gewinn liegt in der Vereinheitlichung. Statt fünf verschiedene SDKs zu verwalten, konfigurierst du einmal das CLI und arbeitest danach mit einem einheitlichen Befehlssatz. Das senkt die kognitive Last und macht Agenten-Workflows leichter wartbar.
FAQ
Brauche ich ein Google-Cloud-Konto, um das CLI zu nutzen? Ja. Du brauchst ein Google-Cloud-Projekt mit aktivierten Workspace-APIs. Die OAuth-Anmeldedaten richtest du einmalig in der Google Cloud Console ein. Danach läuft die Authentifizierung vollautomatisch.
Funktioniert das Tool in CI/CD-Pipelines ohne Browser? Ja. Du kannst Service-Account-Credentials statt des interaktiven OAuth-Flows nutzen. Das macht das CLI auch für vollautomatisierte GitHub-Actions-Workflows oder Server-Deployments einsetzbar, ohne manuelle Anmeldung.
Kann Claude Code das Google Workspace CLI direkt aufrufen? Claude Code führt Shell-Befehle aus. Das Google Workspace CLI ist ein Shell-Befehl. Du musst Claude Code über die CLAUDE.md mitteilen, welche Sheet-IDs, Calendar-IDs oder Mailbox-Konfigurationen relevant sind. Den Rest, also den konkreten Befehlsaufruf, übernimmt Claude.
Komm in die kostenlose Claude Business Community: Lerne Claude, Automatisierung, Co-Work, Claude Code, App-Building und Agent-Coding. Zeit sparen, Kosten sparen, Business skalieren. Jetzt kostenlos beitreten.
Marcel Porcher, newways.ai