Google Workspace CLI: Gmail, Drive & Calendar vom Terminal aus automatisieren

8apps-Team·

Lerne, wie du die Google Workspace CLI (gws) installierst und verwendest, um Gmail, Drive, Calendar und Sheets zu automatisieren. Mit Vibe-Coding-Vorlagen und echten Workflow-Beispielen.

Jeden Tag spielen Millionen von Menschen dasselbe ineffiziente Spiel: Gmail öffnen, herumklicken, Drive in einem anderen Tab öffnen, nach einer Datei suchen, zu Calendar wechseln, etwas in ein Doc einfügen. Das ist in Ordnung — aber es sind auch Tausende kleiner Klicks, die sich zu Stunden summieren, die du nie zurückbekommst.

Anfang März 2026 änderte sich etwas. Google hat leise ein Tool ausgeliefert, das dir erlaubt, mit all dem — Gmail, Drive, Calendar, Sheets, Docs, Chat — über eine einzige Zeile in deinem Terminal zu kommunizieren. Es heißt gws, und es erreichte in seiner ersten Woche Platz 1 auf Hacker News mit über 500 Punkten und 22.000 GitHub-Sternen.

Das ist nicht nur für Entwickler. Wenn du dir je gewünscht hast, dass Google Workspace einfach etwas für dich erledigt — und bereit bist, 20 Minuten in die Einrichtung zu investieren — ist das dein Ausgangspunkt.

⚠️ Hinweis: gws ist Pre-v1 und wird von Google nicht offiziell unterstützt. Es ist Open Source (Apache 2.0). Großartig für persönliche Automatisierung und Experimente — nicht für den Einsatz in der Produktion empfohlen, ohne gründliche Tests.


Was ist die Google Workspace CLI?

Denke an gws als universelle Fernbedienung für dein gesamtes Google Workspace. Statt zwischen fünf verschiedenen Apps in deinem Browser zu navigieren, tippst du einen Befehl und erhältst sofort ein strukturiertes Ergebnis. Keine Ladebildschirme. Kein Klicken. Kein Tab-Wechsel.

Was es wirklich clever macht: Anstatt eine feste Liste von Befehlen auszuliefern, liest es Googles eigenen Discovery Service zur Laufzeit und baut seine Befehlsoberfläche spontan auf. Das bedeutet, wenn Google einen neuen API-Endpunkt hinzufügt, nimmt gws ihn automatisch auf — kein Paket-Update erforderlich. Jede Antwort kommt als strukturiertes JSON zurück, was wunderbar mit KI-Agenten, Shell-Skripten und allem anderen funktioniert, das saubere Daten liest.

DienstWas du automatisieren kannst
📬 GmailE-Mails auflisten, suchen, senden, antworten und triagieren
📁 DriveDateien hochladen, auflisten, suchen und erstellen
📅 CalendarDeinen Terminkalender abrufen, Ereignisse erstellen — zeitzonen-bewusst
📊 Sheets & DocsBereiche lesen, Zeilen anhängen, Dokumente erstellen
💬 ChatNachrichten an Spaces und Nutzer senden
🤖 KI-Agenten100+ vorgefertigte Skills und ein integrierter MCP-Server

Wie Power-User es tatsächlich nutzen

Das Montags-Morgen-Posteingang-Briefing

Der meistzitierte Anwendungsfall seit dem Launch. Anstatt Gmail zu öffnen und in ungelesenen E-Mails zu ertrinken, verbinden Nutzer einen KI-Agenten — Claude Code, Gemini CLI oder alles, was Terminalbefehle ausführen kann — um ihren Posteingang automatisch zu verarbeiten:

Prompt an deinen KI-Agenten: Lese meine letzten 10 E-Mails. Entscheide für jede, ob sie dringend ist, eine Aktion erfordert oder nur informativ ist. Erstelle dann eine Google Slides-Präsentation namens "Executive Briefing", ein Google Doc namens "Wöchentliche Briefing-Notizen" und protokolliere alle 10 in einer Google Tabelle mit Spalten für Absender, Priorität, Frist und Maßnahme.

Vor gws war das ein Zapier-Workflow, drei separate APIs und ein Wochenende Debugging. Jetzt ist es ein Prompt an einen Agenten, der bereits Zugriff auf alles hat.

Vertrags- & Dokumenten-Workflows

Ein Agent liest eine neue Vertrags-E-Mail, extrahiert Schlüsselbegriffe in ein geteiltes Google Doc, legt Anhänge in Drive ab, benachrichtigt das Rechtsteam in Chat und markiert die Überprüfungsfrist im Calendar — alles ausgelöst durch eine einzige eingehende E-Mail. Diese Art von mehrstufiger, app-übergreifender Automatisierung war bisher nur mit benutzerdefiniertem API-Code oder teuren No-Code-Plattformen möglich.

Zapier für Workspace-native Flows ersetzen

Für Workflows, die vollständig innerhalb von Google Workspace ablaufen, kann gws bezahlte Automatisierungstools ersetzen. Keine Preisgestaltung pro Vorgang, kein Workflow-Builder zu erlernen, kein Plattform-Lock-in. Community-Mitglieder berichten, dass sie Zapier-Pläne für 50–100 USD/Monat für ihre Workspace-Automatisierungen ersetzen.

Wichtige Einschränkung: gws ist Google-zu-Google. Wenn dein Workflow Salesforce, HubSpot oder Slack benötigt, brauchst du immer noch Zapier oder n8n für diese Verbindungen. Aber für Workflows, die innerhalb von Workspace bleiben, deckt dies die Automatisierungsschicht ab, für die du monatlich gezahlt hast.


Einrichtung in 4 Schritten

Schritt 1 — Node.js installieren, dann gws installieren

Prüfe, ob du Node hast, indem du node --version in deinem Terminal eingibst. Falls nicht, lade es von nodejs.org herunter. Dann führe aus:

npm install -g @googleworkspace/cli

# Korrekte Installation überprüfen
gws --version

Schritt 2 — Ein Google Cloud-Projekt erstellen

Gehe zu console.cloud.google.com, erstelle ein neues Projekt (beliebiger Name), navigiere dann zu APIs & Dienste → Anmeldedaten → OAuth 2.0-Client-ID erstellen und wähle Desktop-App. Lade die JSON-Datei herunter — das ist dein Schlüssel.

Wenn du bereits gcloud CLI installiert hast, überspringe all das und führe einfach gws auth setup aus — es übernimmt die gesamte Cloud-Projekt-Einrichtung automatisch.

Schritt 3 — Authentifizieren

gws auth login
# Browser öffnet sich → Zugriff genehmigen → fertig
# Anmeldedaten werden verschlüsselt in deinem OS-Schlüsselring gespeichert

⚠️ Gmail-Konten im Test-Modus: Google begrenzt nicht verifizierte Apps auf ~25 OAuth-Scopes. Wenn du die Scope-Auswahl siehst, wähle einzelne Dienste (nur Gmail oder nur Drive) statt "Alle auswählen", um dieses Limit nicht zu erreichen.

Schritt 4 — API aktivieren & ersten Befehl ausführen

Aktiviere die spezifische API (Drive, Gmail usw.) für dein Projekt im Cloud Console-Dashboard und probiere dann deinen ersten Befehl:

# Deine Google Drive-Dateien auflisten
gws drive files list

# Auf die ersten 10 Ergebnisse begrenzen
gws drive files list --params '{"pageSize": 10}'

# Bevorstehende Kalender-Ereignisse prüfen
gws calendar events list --params '{"calendarId":"primary","maxResults":5}'

# Alle verfügbaren Befehle für einen Dienst erkunden
gws gmail --help

Deine erste Automatisierung mit Vibe-Coding erstellen

Du musst keine Skripte von Grund auf neu schreiben. Beschreibe, was du willst, in einfacher Sprache, füge es in Claude, ChatGPT oder Gemini ein und erhalte in Minuten funktionierenden Code zurück. Hier sind drei gebrauchsfertige Prompts.

Vorlage 1 — Täglicher E-Mail-Digest am Morgen

Schreibe ein Bash-Skript, das die Google Workspace CLI (gws) verwendet, um
meine letzten 20 ungelesenen Gmail-Nachrichten als JSON abzurufen, jede
mit Claude zusammenzufassen und die Ausgabe als morning-brief.md in meinem
Home-Verzeichnis zu speichern. Füge Absender, Betreff und eine einzeilige
Zusammenfassung pro E-Mail ein.

Vorlage 2 — Anhänge automatisch in Drive ablegen

Schreibe ein Python-Skript, das gws (über subprocess) verwendet, um Gmail
nach E-Mails mit PDF-Anhängen aus den letzten 7 Tagen zu durchsuchen,
jeden Anhang herunterzuladen und ihn in einen Google Drive-Ordner namens
"Posteingang-Anhänge" hochzuladen, indem gws drive files create mit dem
--upload-Flag verwendet wird.

Vorlage 3 — Wöchentlicher Sheets-Bericht (cron-fertig)

Schreibe ein Bash-Skript, das ich via Cron jeden Freitag um 17 Uhr
ausführen kann. Es soll gws verwenden, um eine Zeile zu einer Google
Tabelle (ID: DEINE_ID_HIER) mit dem heutigen Datum, der Anzahl der
E-Mails, die ich diese Woche erhalten habe (aus gws gmail), und der
Anzahl der Kalender-Ereignisse, die ich hatte (aus gws calendar),
hinzuzufügen.

💡 Schlüssel zu guten Ergebnissen: Teile deiner KI immer mit (1) welchen gws-Dienst du anvisierst, (2) dass Ausgaben JSON sind, und (3) genau was das Endergebnis sein soll — eine Datei, eine E-Mail, eine Tabellenzeile. Je spezifischer du beim Endzustand bist, desto sauberer wird der Code sein, den du zurückbekommst.


Welcher Power-User-Typ bist du?

Dein ProfilDein bester Ausgangspunkt
📋 Operations-Person — verwaltet Prozesse, hasst repetitive Admin-ArbeitVorlage 3: deinen wöchentlichen Team-Bericht automatisieren
✉️ Inbox-Zero-Jäger — lebt in Gmail, ertrinkt in E-Mailsgws gmail +triage + Morgens-Digest-Skript
📊 Daten-Jongleur — zieht ständig Daten in Tabellengws sheets + --page-all-Flag für Massendaten-Abrufe
🤖 KI-Tüftler — nutzt bereits Claude Code oder GeminiMCP-Server: gws mcp -s drive,gmail,calendar

Ehrliche Einschränkungen vor dem Einstieg

Es ist Pre-v1. Befehle, Flags und Ausgabeformate können sich zwischen Releases ändern. Wenn du etwas Wichtiges baust, fixiere auf eine bestimmte Version: npm install -g @googleworkspace/cli@x.x.x.

Die Einrichtung dauert ~20–30 Minuten. Der Google Cloud-Projekt-Schritt ist der Hauptreibungspunkt. Nutze gws auth setup, wenn du gcloud hast — es automatisiert das meiste davon.

Scope-Limits betreffen persönliche Gmail-Konten. Im Test-Modus begrenzt Google nicht verifizierte Apps auf ~25 OAuth-Scopes. Wähle einzelne Dienste in der Scope-Auswahl, nicht "alle".

Kein Multi-Plattform-Tool. gws deckt alles innerhalb von Googles Ökosystem ab. Für Workflows, die externe Tools wie Slack oder Salesforce berühren, brauchst du immer noch eine Connector-Schicht.


Heute loslegen

Ein Befehl zum Installieren. Ein Wochenende, um das zu automatisieren, was dich seit Monaten nervt.

npm install -g @googleworkspace/cli

Bevorzugst du No-Code? Probiere 8apps Add-ons

Wenn Terminalbefehle nichts für dich sind, kannst du Google Workspace immer noch mit unseren fertigen Add-ons automatisieren. Sie laufen nativ in Gmail, Sheets und Drive ohne komplexe Einrichtung:

  • Contact Extractor: Erstelle sofort deine Verkaufsliste, indem du Namen, E-Mails und Telefonnummern aus Gmail in Google Sheets holst.
  • Currency Converter: Wandle Live-Währungswerte mühelos direkt in deinen Google Sheets um.
  • Drive Guard: Prüfe und verwalte Dateiberechtigungen sicher in deinem Google Drive.
  • GPT Mate: Entwerfe E-Mails und Inhalte automatisch, indem du ChatGPT und Gemini direkt in Google Docs und Sheets bringst.
  • Hash Data: Schütze sensible Informationen und personenbezogene Daten, indem du Daten in Google Sheets schnell hashst.
  • Mail My Sheets: Automatisiere dein Reporting, indem du Snapshots deiner Sheets planmäßig per E-Mail versendest.
  • Mail to Drive: Halte Aufzeichnungen sicher, indem du wichtige E-Mails und Anhänge automatisch als PDFs in Drive speicherst.

Hast du einen benutzerdefinierten Workflow im Sinn?
Wir können ein maßgeschneidertes Google Workspace Add-on genau auf deine Geschäftsprozesse zugeschnitten entwickeln. Schreibe uns an support@8apps.co, um loszulegen!