gws: Google Workspace CLI pro AI agenty

Začátkem března 2026 Google tiše pushoval na GitHub nástroj, který na první pohled vypadá jako další CLI pro správu firemních nástrojů.

Jenže gws není postavený pro lidi. Je postavený pro AI agenty – a to je přesně to, proč stojí za pozornost.

Co je Google Workspace CLI pro AI agenty

gws je open-source command-line interface pro celý Google Workspace ekosystém:

Gmail
Google Drive
Google Calendar
Google Sheets
Google Docs
Google Chat
Google Admin

Technické parametry

Napsaný v Rustu
Distribuovaný přes npm
Licence Apache 2.0
100+ předdefinovaných agent skills

Na povrchu: jeden nástroj místo pěti webových konzolí.

Pod povrchem: runtime infrastruktura pro AI agenty, kde human usage je vedlejší produkt.

Design pro stroje, ne pro terminál

Google to říká přímo. Celý design – JSON output, granulární oprávnění, vestavěný MCP server – dává smysl hlavně v kontextu autonomních agentů, kteří potřebují spolehlivé, parsovatelné rozhraní k datům.

Srovnej to s GAM (Google Apps Manager), de facto standardem posledních 15 let:

Nástroj	Optimalizace	Output	Použití
GAM	Lidi a shell skripty	Pro terminál	Manuální operace
gws	AI agenty a LLM	Pro stroje (JSON first)	Autonomní procesy

gws jde opačným směrem než tradiční CLI – output je primárně pro stroje, terminál je bonus.

Dynamic Discovery: CLI, které se samo aktualizuje

Tohle je technicky nejzajímavější rozhodnutí celého projektu.

Problém s tradičním CLI

Tradiční CLI funguje ve starém modelu:

Vývojář přidá nový API endpoint
Napíše handler
Vydá novou verzi
Uživatel aktualizuje

Výsledek: pomalé, manuální, náchylné k zaostávání za API.

Řešení: Dynamic Discovery Service

gws čte za běhu Google Discovery Service – centrální katalog všech Google API.

Výsledek:

Nový Workspace endpoint? gws ho automaticky “umí”
Bez jakékoliv aktualizace CLI
Bez čekání na vydání nové verze
Okamžitý přístup k novým funkcím

Příklad:

# Tenhle příkaz funguje i pro endpoint, který vznikl minulý týden
gws gmail:messages.list --userId me --maxResults 10

Dopad pro AI agenty

Vývojáři a AI agenty mají automaticky přístup k celému aktuálnímu Workspace API – ne jen k verzi, kterou někdo zahardcodoval.

Je to stejný princip, jako když LLM dostane přístup k live dokumentaci místo statického kontextového okna.

MCP server v praxi: Claude Desktop, Gemini CLI, VS Code

Google si pro integraci AI agentů vybral Model Context Protocol (MCP) – stejný standard, který stojí za integrací nástrojů v Claude Desktop nebo Cursor IDE.

Jak spustit MCP server

gws mcp

To je celé. gws nastartuje MCP server, který exponuje Workspace operace jako nástroje dostupné libovolnému MCP-kompatibilnímu klientovi.

Praktická aplikace s Claude

Přidáš ho do claude_desktop_config.json a Claude najednou umí:

Přímo číst tvůj Gmail
Vytvářet události v Kalendáři
Prohledávat Google Drive
Čtení a tvorba v Docs a Sheets
Bez custom integrace, bez Zapier, bez n8n

Granulární oprávnění a bezpečnost

Každý agent dostane přesně to, co potřebuje:

Agent pro zpracování dokumentů → přístup jen na Drive a Docs
Scheduling agent → vidí jen Calendar
Support agent → přístup na Gmail a Drive

Žádné superuživatelské tokeny. Minimální riziko.

Ochrana před útoky:

--sanitize flag přidává vrstvu ochrany před prompt injection přes Google Cloud Model Armor. To je kritické, protože AI agent čtoucí Gmail čte nedůvěryhodný obsah – kdokoliv ti může poslat mail navržený tak, aby manipuloval agenta.

Základní příkazy a příklady pro AI agenty

Instalace a nastavení

npm install -g @google/gws
gws auth login

Praktické příkazy

Gmail: posledních 20 mailů jako JSON

gws gmail:list --maxResults 20

Google Drive: soubory v root složce

gws drive:list

Google Calendar: události tento týden

gws calendar:events --timeMin 2026-03-14T00:00:00Z --timeMax 2026-03-21T00:00:00Z

Google Sheets: data z konkrétního sheetu

gws sheets:values.get --spreadsheetId SHEET_ID --range "List1!A1:D10"

Dry run – kontrola bez spuštění

gws gmail:send --to "kolega@firma.cz" --subject "Test" --dry-run

Výhody JSON outputu

Strukturovaná data umožňují:

Přímou integraci do shell pipeline
Přímé použití v Python agentech
Kompatibilitu s LLM agentic frameworky
Auto-pagination pro velké datové sady
Ruční řešení nextPageToken není potřeba

Proč jde o paradigma shift: od lidí k agentům

Dlouhá léta platilo nepsané pravidlo: software píšeš pro lidi, a pokud chtějí stroje automatizovat, dáš jim API.

CLI bylo vždy “human layer” – terminál pro adminy a vývojáře.

gws tohle pravidlo otáčí. CLI jako primární rozhraní pro AI agenty, kde lidské použití je vedlejší případ.

Tři důvody, proč je to důležité

1. Composability

CLI příkazy se přirozeně skládají do pipeline
AI agent dokáže kombinovat gmail:list, filtrování a calendar:events způsoby, které statické API neumožňují bez custom kódu

2. Zero-cost automation

gws + CrewAI nebo LangChain nahrazuje to, co Zapier účtuje měsíčně
Bez vendor lock-inu, bez no-code limitací
Plná kontrola nad logikou
Nižší bariéra než no-code, vyšší než klikání v UI

3. Infrastruktura místo integrace

Zapier, Make, n8n jsou integrace – propojení dvou konkrétních systémů
gws je infrastruktura – vrstva existující bez ohledu na to, který agent ji využívá
Architektonický rozdíl, který roste s počtem use cases

Důležitá poznámka

gws je v0.15, “not officially supported” a Google explicitně varuje před breaking changes.

Není to produkční enterprise nástroj. Je to ukazatel směru – a ten směr je jasný.

Svět, kde AI agenti mají standardizovaný, bezpečný přístup k firemním datům přes otevřený protokol, není vzdálená vize. Je to to, co Google právě shipl na GitHub.

Jak začít s implementací AI agentů do vaší firmy

Zajímá tě, jak do architektury tvého produktu nebo firmy zapojit AI agenty, kteří reálně fungují a nepáchají škody?

Máme pro tebe tři možnosti:

1. Zjisti stav tvého AI stack

Objednej si AI audit – zjistíme, kde to dává smysl a kde je to jen hype.

2. Podívej se na naše služby

Chceš vědět, co všechno děláme? Projdi si naše služby – jak pracujeme s klienty a kde vidíme největší příležitosti.

3. Popiš svůj projekt přímo

Chceš zkonsultovat konkrétní věc? Ozvi se nám – odpovíme do 24 hodin.

Další články o AI automatizaci:

Chceš se o tom dozvědět víc? Vrať se do našeho blogu – tam máme další materiály o AI agentech a automatizaci.

Sdílejte článek

Pomohl vám článek? Sdílejte ho s kolegy, kterým by se mohl hodit.