# gws: conecta agentes con operaciones de Google Workspace

> Consulta Drive, Gmail y otras API de Workspace con una CLI y skills que describen sus operaciones.

Verificado el 27 oct 2026.

## Qué es

gws es una herramienta de terminal que construye comandos a partir del servicio de descubrimiento de Google. Incluye skills para API y recetas de flujos frecuentes; el README aclara que no es un producto con soporte oficial de Google.

## Para qué te sirve

- Cuando el agente necesita listar archivos con salida estructurada.
- Cuando quieres preparar un flujo entre aplicaciones sin escribir cada cliente de API.

## Cómo funciona

La CLI descubre operaciones de API y devuelve JSON. Las skills explican cómo invocarlas y los helpers cubren tareas frecuentes. La autenticación y los permisos se resuelven mediante un proyecto de Google Cloud y OAuth.

## Antes de empezar

Necesitas una cuenta con acceso a Workspace y un proyecto Cloud. El paquete npm requiere Node.js 18 o posterior según el README, o puedes descargar un binario. Los permisos y cuotas dependen de las API utilizadas.

## Límites y alternativas

La amplitud de comandos exige acotar permisos y acciones del agente. El proyecto avisa de posibles cambios incompatibles antes de su versión estable. Empieza por lectura y evita conceder acceso general a correo y archivos.

## Recursos

- [Proyecto y documentación](https://github.com/googleworkspace/cli) — consulta el README y sus ejemplos antes de instalar.
- [Datos del repositorio](https://github.com/googleworkspace/cli) — 31917 estrellas; licencia detectada por GitHub: Apache-2.0.
- [Condiciones de licencia](https://github.com/googleworkspace/cli/blob/main/LICENSE) — revisa el texto aplicable antes de redistribuir.
- [Actividad reciente](https://github.com/googleworkspace/cli/commits/main/) — último commit consultado: 2026-03-31.