What problem it solves

Accessing Google Workspace APIs from the command line can require repetitive request construction, manual pagination, and custom tooling for agents. The project addresses this by generating its command surface from Google Discovery Service and producing structured JSON output across Workspace services.

Key features

• Dynamic Workspace command surface — The CLI reads Google's Discovery Service at runtime and builds commands from API resources and methods, allowing newly added endpoints and methods to become available automatically.

  Source: README

• Structured output and request previews — Responses use structured JSON, while help text, dry runs, schema introspection, and pagination support make commands easier to inspect and automate.

  Source: README

• Multiple authentication workflows — Authentication supports interactive desktop setup, manual OAuth configuration, browser-assisted login, exported credentials for CI, service accounts, and pre-obtained access tokens.

  Source: README

• Hand-crafted service helpers — Service-specific helper commands provide common operations such as sending email, appending spreadsheet values, uploading files, showing agendas, and creating workflow summaries.

  Source: README, skills

• Agent skills and extension support — The repository includes Agent Skills for supported APIs, higher-level helpers, and curated recipes, as well as instructions for adding them to agent environments and installing the Gemini CLI extension.

  Source: README, gemini-extension.json

Quick start

Copied verbatim from the project's README.

npm install -g @googleworkspace/cli

gws auth setup     # walks you through Google Cloud project config
gws auth login     # subsequent OAuth login
gws drive files list --params '{"pageSize": 5}'

Who it may suit

This may suit developers, administrators, and automation users who need to work with Google Workspace from a terminal. It may also suit AI-agent builders that need structured commands and reusable skills.

Topics to discuss

• Which authentication workflow should be the most convenient default for local, CI, and server environments?

• Which Google Workspace workflows should receive additional hand-crafted helper commands?

• How can the included agent skills be improved for a broader range of agent environments?

Written by ReadmeX AI from the project's README, source and public GitHub data; it may contain mistakes.

Read the original README https://github.com/googleworkspace/cli#readme

ReadmeX opened this community for a trending project; it is not run by the project. Maintainers can claim it from the community page.