# Google Workspace CLI: Gmail, Drive & Calendar vom Terminal aus automatisieren > 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. - Source: https://www.8apps.co/de/blog/google-workspace-gws-cli-automatisierung - Markdown: https://www.8apps.co/de/blog/google-workspace-gws-cli-automatisierung.md - Published: 2026-03-25 - Author: 8apps-Team - Language: de --- 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. | Dienst | Was du automatisieren kannst | | ---------------- | ------------------------------------------------- | | 📬 Gmail | E-Mails auflisten, suchen, senden, antworten und triagieren | | 📁 Drive | Dateien hochladen, auflisten, suchen und erstellen | | 📅 Calendar | Deinen Terminkalender abrufen, Ereignisse erstellen — zeitzonen-bewusst | | 📊 Sheets & Docs | Bereiche lesen, Zeilen anhängen, Dokumente erstellen | | 💬 Chat | Nachrichten an Spaces und Nutzer senden | | 🤖 KI-Agenten | 100+ 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](https://nodejs.org) herunter. Dann führe aus: ```bash npm install -g @googleworkspace/cli # Korrekte Installation überprüfen gws --version ``` ### Schritt 2 — Ein Google Cloud-Projekt erstellen Gehe zu [console.cloud.google.com](https://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 ```bash 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: ```bash # 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 Profil | Dein bester Ausgangspunkt | | ------------------------------------------------------------- | ---------------------------------------------------- | | 📋 **Operations-Person** — verwaltet Prozesse, hasst repetitive Admin-Arbeit | Vorlage 3: deinen wöchentlichen Team-Bericht automatisieren | | ✉️ **Inbox-Zero-Jäger** — lebt in Gmail, ertrinkt in E-Mails | `gws gmail +triage` + Morgens-Digest-Skript | | 📊 **Daten-Jongleur** — zieht ständig Daten in Tabellen | `gws sheets` + `--page-all`-Flag für Massendaten-Abrufe | | 🤖 **KI-Tüftler** — nutzt bereits Claude Code oder Gemini | MCP-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. - 🐙 [GitHub Repo](https://github.com/googleworkspace/cli) - 📦 [npm-Paket](https://www.npmjs.com/package/@googleworkspace/cli) - 📖 [Agenten-Skills-Dokumentation](https://github.com/googleworkspace/cli/blob/main/docs/skills.md) ```bash 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](/de/google-workspace/contact-extractor)**: Erstelle sofort deine Verkaufsliste, indem du Namen und E-Mail-Adressen aus Gmail in Google Sheets holst. - **[Currency Converter](/de/google-workspace/currency-converter)**: Wandle Live-Währungswerte mühelos direkt in deinen Google Sheets um. - **[Drive Guard](/de/google-workspace/drive-guard)**: Prüfe und verwalte Dateiberechtigungen sicher in deinem Google Drive. - **[GPT Mate](/de/google-workspace/gpt-mate)**: Entwerfe E-Mails und Inhalte automatisch, indem du ChatGPT und Gemini direkt in Google Docs und Sheets bringst. - **[Hash Data](/de/google-workspace/hash-data)**: Schütze sensible Informationen und personenbezogene Daten, indem du Daten in Google Sheets schnell hashst. - **[Mail My Sheets](/de/google-workspace/mail-my-sheets)**: Automatisiere dein Reporting, indem du Snapshots deiner Sheets planmäßig per E-Mail versendest. - **[Mail to Drive](/de/google-workspace/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](mailto:support@8apps.co), um loszulegen!