Obsah

Google Workspace CLI (gws)

Vytvořeno: 14.6.2026 | Aktualizováno: 14.06.2026 09:05

Google Workspace CLI (příkaz gws) je open-source CLI nástroj pro práci s Google Workspace API z terminálu. Pro AI část wiki je zajímavý hlavně tím, že vrací strukturovaný JSON, umí introspektovat API schémata a repozitář obsahuje Agent Skills pro Drive, Gmail, Calendar, Sheets, Docs, Chat a další služby. Projekt výslovně uvádí, že nejde o oficiálně podporovaný produkt Googlu a že před verzí 1.0 lze čekat breaking changes.

Poznámka: Jde o rešeršní zápisek podle README dokumentace projektu. Lokální otestování s vlastním Google účtem zde zatím není zaznamenané.

Co gws řeší

gws poskytuje jedno CLI pro větší část ekosystému Google Workspace. Místo ručního psaní REST volání načítá za běhu Google Discovery Service a podle něj dynamicky staví dostupné příkazy.

Praktický dopad:

Instalace

Doporučená instalace je stažení předpřipraveného binárního balíčku z GitHub Releases. Alternativně lze použít npm balíček, který stáhne odpovídající binárku, build z Rust zdrojů, Nix nebo Homebrew. 

npm install -g @googleworkspace/cli
cargo install --git https://github.com/googleworkspace/cli --locked
nix run github:googleworkspace/cli
brew install googleworkspace-cli

Základní předpoklady podle dokumentace:

První spuštění a autentizace

Nejjednodušší lokální workflow je: 

gws auth setup
gws auth login
gws drive files list --params '{"pageSize": 5}'

gws auth setup provádí uživatele nastavením Google Cloud projektu a OAuth klienta. Pokud je OAuth aplikace v testing režimu, je potřeba přidat svůj účet mezi testovací uživatele. U neověřené aplikace je také limit počtu scope; dokumentace doporučuje vybrat jen služby, které jsou skutečně potřeba: 

gws auth login -s drive,gmail,sheets

Pro headless nebo serverové použití dokumentace uvádí také práci s exportovanými credentials, service account souborem nebo předaným access tokenem přes proměnné prostředí: 

export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/credentials.json
export GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token)

Příklady použití

Vypsání posledních souborů z Drive: 

gws drive files list --params '{"pageSize": 10}'

Vytvoření Google Sheets dokumentu: 

gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}'

Odeslání zprávy do Google Chatu s náhledem requestu bez skutečného provedení: 

gws chat spaces messages create \
  --params '{"parent": "spaces/xyz"}' \
  --json '{"text": "Deploy complete."}' \
  --dry-run

Zjištění schématu konkrétní metody: 

gws schema drive.files.list

Stránkovaný výstup jako NDJSON: 

gws drive files list --params '{"pageSize": 100}' --page-all

Agent Skills a použití s AI agenty

Repozitář obsahuje Skills Index s dovednostmi pro jednotlivé služby, helper příkazy, persony a recepty. To je hlavní důvod, proč článek patří do AI části: cílem není jen ruční CLI, ale i bezpečnější a strukturovanější ovládání Workspace služeb agentem.

Instalace všech skills: 

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

Instalace jen vybraných skills: 

npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-drive
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail

Projekt obsahuje také Gemini CLI extension konfiguraci. Typický postup podle dokumentace: 

gws auth setup
gemini extensions install https://github.com/googleworkspace/cli

Po instalaci extension může Gemini CLI agent volat gws příkazy a využít existující lokální autentizaci.

Helper příkazy

Kromě dynamicky generované příkazové plochy podle Discovery API obsahuje gws i ručně připravené helper příkazy s prefixem +. Ty zjednodušují časté operace, například:

Příklady: 

gws gmail +send --to alice@example.com --subject "Hello" --body "Hi there"
gws calendar +agenda
gws workflow +standup-report

Bezpečnost a omezení

Důležité body před praktickým nasazením:

Kdy to dává smysl

gws dává smysl tam, kde je potřeba Google Workspace ovládat skriptovatelně a zároveň čitelně pro agenta:

Zdroje