Repolode
Enviar
googleworkspace

googleworkspace/cli

A command-line tool that gives one interface to Google Workspace APIs like Drive, Gmail, Calendar, Sheets, Docs, and Chat, with JSON output for scripts and AI agents.

Ver en GitHubSitio web
Estrellas
31,672
Forks
2,017
Issues abiertos
136
Último commit
hace 13 días

¿Qué es?

gws is a command-line client for Google Workspace. Instead of hand-writing curl calls against REST endpoints, you run commands such as gws drive files list or gws sheets spreadsheets create. The command set is built at runtime from Google's Discovery Service, so newly added API methods become available without a tool update. Every resource has --help, --dry-run previews a request before it is sent, and --page-all streams paginated results as NDJSON.

All output, including errors, is structured JSON, which makes the tool easy to pipe into jq or other scripts. The repository also ships over 100 Agent Skills (SKILL.md files) covering each supported API plus higher-level workflow helpers, and a Gemini CLI extension that lets an agent use the same commands with the authentication you already set up.

Authentication supports interactive OAuth login with encrypted local storage, manual Google Cloud OAuth client setup, service accounts, pre-obtained access tokens, and exported credentials for headless CI. Installation is available through GitHub Releases, npm, Cargo, Nix, and Homebrew. The project is written in Rust, is Apache-2.0 licensed, and is stated to be under active development with possible breaking changes before v1.0.

Funciones clave

  • 01Dynamically builds commands from Google's Discovery Service, so new API methods appear automatically.
  • 02Outputs structured JSON for every response, including errors.
  • 03Supports --dry-run to preview requests and --page-all for NDJSON pagination.
  • 04Ships 100+ Agent Skills and a Gemini CLI extension for AI agent use.
  • 05Offers multiple auth paths: interactive OAuth, service accounts, access tokens, and exported credentials for CI.

Casos de uso

  • Scripting routine Drive, Sheets, or Gmail operations from a terminal or CI job.
  • Letting an AI agent read calendars, send emails, or update spreadsheets through structured commands.
  • Automating Google Chat notifications, such as posting a message after a deploy.
  • Piping Workspace data into jq or other shell tools for reporting.

Temas

#google-workspace#cli#google-api#ai-agent#automation#oauth2#rust#agent-skills#discovery-api#gemini-cli-extension

Preguntas frecuentes

¿Qué es cli?
A command-line tool that gives one interface to Google Workspace APIs like Drive, Gmail, Calendar, Sheets, Docs, and Chat, with JSON output for scripts and AI agents. gws is a command-line client for Google Workspace. Instead of hand-writing curl calls against REST endpoints, you run commands such as gws drive files list or gws sheets spreadsheets create. The command set is built at runtime from Google's Discovery Service, so newly added API methods become available without a tool update. Every resource has --help, --dry-run previews a request before it is sent, and --page-all streams paginated results as NDJSON.
¿cli es gratuito? ¿Qué licencia tiene?
cli es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿cli sigue mantenido?
Mantenimiento activo. El último commit de cli fue el 6 oct 2026.
¿Para qué puedo usar cli?
Scripting routine Drive, Sheets, or Gmail operations from a terminal or CI job. Letting an AI agent read calendars, send emails, or update spreadsheets through structured commands. Automating Google Chat notifications, such as posting a message after a deploy. Piping Workspace data into jq or other shell tools for reporting.
¿Dónde consigo cli?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/googleworkspace/cli

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados