Emre Demir

Posted on Mar 17 • Originally published at apidog.com

Google Workspace CLI: Anleitung und Anwendung

Die Google Workspace CLI (gws) ist ein quelloffenes, dynamisches Befehlszeilentool für Entwickler und KI-Agenten, das einen einheitlichen Zugriff auf Dienste wie Drive, Gmail, Kalender, Tabellen, Docs, Chat, Admin und alle Google Workspace APIs ermöglicht. Es generiert die Befehle zur Laufzeit direkt aus Googles Discovery-Dienst – Sie bleiben ohne Updates immer aktuell. Installation erfolgt global via npm, einmalige OAuth-Authentifizierung genügt, und die Integration mit Agenten wie Claude Code oder Cursor ist sofort möglich. Boilerplate-OAuth-Flows und einzelne SDKs entfallen.

Teste Apidog noch heute

Warum Google Workspace CLI?
Ob Entwickler, Admin oder KI-Agent – die Automatisierung und Abfrage von Google Workspace-Diensten (Drive-Dateien, Gmail, Kalender, Tabellen, Docs, Chat) ist oft mühsam: eigene Curl-Skripte, Scope-Verwaltung, manuelle Paginierung, veraltete SDKs. Die APIs sind mächtig, aber fragmentiert und ändern sich häufig. Die Google Workspace CLI löst das – eine einzige, Rust-basierte CLI mit Live-Discovery aller Workspace APIs. Neue Endpunkte stehen sofort zur Verfügung.

Ihre Skripte und Automatisierungen bleiben so immer aktuell. Die CLI liefert JSON-Ausgaben, unterstützt Dry-Runs, automatische Paginierung und über 40 Hilfsbefehle (z. B. gws gmail +send oder gws calendar +agenda).

Die CLI enthält sofort einsatzbereite Agenten-Fähigkeiten. Tools wie Claude Code, Cursor oder Gemini CLI können den Workspace direkt steuern – ohne zusätzliche Tool-Definitionen.

Für parallele API-Integrationen empfiehlt sich Apidog als API-Client. Mit Apidog können Sie Anfragen senden, Antworten überprüfen, Umgebungen verwalten und Tests automatisieren – optimal in Kombination mit der Google Workspace CLI.

Google Workspace CLI installieren

Benötigt wird Node.js ab Version 18:

node --version

Schnellstart mit npx (ohne Installation)

npx @googleworkspace/cli --help
npx @googleworkspace/cli drive files list --params '{"pageSize":1}'

Ideal für Tests und einmalige Skripte.

Global installieren

npm install -g @googleworkspace/cli
gws --version

Die CLI kommt als vorgefertigte Binärdatei – kein Rust-Build nötig. Alternativ gibt es GitHub-Releases, Homebrew (brew install googleworkspace/cli) oder Nix.

Google Workspace CLI für KI-Agents einrichten

Initiale Einrichtung und OAuth-Autorisierung (Projektanlage, API-Aktivierung) mit:

gws auth setup

Dies öffnet den Browser, legt ein Cloud-Projekt an (falls nötig), aktiviert APIs und speichert Credentials verschlüsselt im Schlüsselbund.

Agenten-Fähigkeiten installieren

npx skills add https://github.com/googleworkspace/cli

Alternativ agentenspezifische Installer nutzen (z. B. für Claude Code, Cursor). Agent neu starten, damit die CLI-Befehle erkannt werden.

Projektweite Einrichtung

gws auth setup --project

Authentifizierung verwalten

Neu anmelden oder Konto wechseln:

gws auth login

Aktuellen User und Scopes prüfen:

gws auth whoami

Abmelden:

gws auth logout

Für CI/Headless-Anwendung:

gws auth export --unmasked > creds.json
export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/creds.json

Oder gcloud-Tokens wiederverwenden:

export GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token)

Telemetrie deaktivieren

export GOOGLE_WORKSPACE_CLI_NO_TELEMETRY=1

Kernbefehle: Drive, Gmail, Kalender, Tabellen, Docs, Chat

Alle Befehle werden dynamisch erkannt. Mit gws --help lassen sich verfügbare Dienste anzeigen.

Drive

Neueste Dateien listen:

gws drive files list --params '{"pageSize":10, "q":"name contains report"}'

Datei hochladen:

gws drive +upload ./budget.xlsx --name "2026 Budget"

Gmail

E-Mail senden:

gws gmail +send --to colleague@example.com --subject "Update" --body "Siehe Anhang." --attach ./file.pdf

Antworten oder Posteingang bearbeiten:

gws gmail +reply --message-id <ID> --body "Danke!"
gws gmail +triage

Kalender

Kalenderereignis erstellen:

gws calendar +insert --summary "Sprint Planung" --start "2026-03-20T10:00" --end "2026-03-20T11:00" --attendees "team@example.com"

Heutige Agenda anzeigen:

gws calendar +agenda --today

Tabellen

Zeile anhängen:

gws sheets +append --spreadsheetId <ID> --range "Sheet1!A:C" --values "Task X,Done,2026-03-16"

Docs

Text einfügen:

gws docs +write --documentId <ID> --text "Neuer Abschnitt über Google Workspace CLI hinzugefügt"

Chat

Nachricht posten:

gws chat +send --space <SPACE_ID> --text "Bereitstellung abgeschlossen 🚀"

--dry-run zeigt vorab den API-Aufruf, --page-all gibt alle Ergebnisse als NDJSON aus.

Erweiterte Konfiguration

Parameter per Umgebungsvariable oder .env setzen:

export GOOGLE_WORKSPACE_CLI_DEFAULT_PARAMS='{"prettyPrint":true}'

Timeouts, Ausgabeformate (--json, --yaml) und Schlüsselbundart sind konfigurierbar. Aktuelle Konfiguration anzeigen:

gws config

Integration mit KI-Agenten und Prompts

Nach der Installation der Skills können Agenten die CLI nativ nutzen.

Prompt-Muster ("use gws")

Beispiel: "Liste meine letzten Drive-Dateien mit Google Workspace CLI" oder "Sende eine Folge-E-Mail über Google Workspace CLI".

Automatisierungsregel

In den Agenten-Anweisungen (z. B. CLAUDE.md):

"Bei Aufgaben für Gmail, Drive, Kalender, Tabellen, Docs oder Chat immer Google Workspace CLI-Befehle verwenden, bevor geantwortet wird. Dienst und Methode zuerst klären."

Agenten geben Dateipfade oder JSON zurück und halten den Kontext schlank.

Kombinieren mit Apidog für zuverlässige API-Tests

Mit der Google Workspace CLI greifen Sie direkt auf Workspace APIs zu. Für Debugging, Payload- und Scope-Checks nutzen Sie Apidog:

Vor dem Append in Sheets die Payload mit Apidog testen.
Gmail-Sendeprobleme visuell anlegen und prüfen.
Dienstkonto-/Benutzer-Tokens als Variablen verwalten und Verhalten validieren.

CLI und Apidog zusammen bieten direkten Zugriff sowie reproduzierbare, geprüfte API-Workflows.

FAQ

Werden Daten extern gesendet?
Nein, alle Befehle gehen direkt an Google APIs. Inhalte verlassen Ihr Google-Konto nicht.

Welche Dienste werden unterstützt?
Jede dynamisch entdeckte Workspace API: Drive, Gmail, Kalender, Tabellen, Docs, Chat, Admin, Skript und mehr.

Wie aktuell sind die Befehle?
Immer aktuell dank Live-Discovery – neue Methoden erscheinen automatisch.

Brauche ich einen API-Schlüssel?
Nein, Standard-Google-OAuth oder Dienstkonten reichen aus.

Welche Agenten/Editoren unterstützt die CLI?
Claude Code, Cursor, OpenClaw, Gemini CLI, VS Code-Erweiterungen und jedes MCP- oder Agent Skills-kompatible Tool.

Unterschied: Rohbefehle vs. +Helfer?
Roh: exakt wie Discovery (z. B. drive.files.list). +Helfer: Abkürzungen für häufige Aufgaben (z. B. +upload, +send).

Kann ich die CLI ohne KI-Agenten nutzen?
Ja, ideal für Skripte, Automatisierung oder den Terminal-Alltag.