gws CLI

A personal command-line client for Google Workspace

This page exists to describe a personal deployment of the open-source Google Workspace CLI (gws) — a terminal tool for reading and writing Google Drive, Sheets, Docs, and Slides.

What it does

It authenticates to Google via OAuth 2.0 and issues requests to the Google Workspace APIs on behalf of the signed-in user, returning structured JSON. For example:

gws drive files list --params '{"pageSize": 10}'
gws slides presentations get --params '{"presentationId": "..."}'

Scope of use

• Run locally by a single individual developer, on their own machine.
• Accesses only that developer's own Google account data.
• No server component; no data is collected or retained by the operator.

Privacy

See the Privacy Policy.

Contact

cozyzeyu@gmail.com

The upstream gws project is published by Google Workspace but is not an officially supported Google product. This page describes an individual's personal use of it and is not affiliated with or endorsed by Google.