gws: Google Workspace en manos del agente con una sola línea de comandos
Conectar un agente a Google Workspace suele exigir envolver a mano una docena de API REST. El CLI gws genera sus comandos al vuelo a partir del Discovery Service de Google y responde en JSON estructurado, y las skills incluidas enseñan al agente a usarlo. La lista de rutas reúne unas 95: una por API, más ayudantes, flujos, perfiles y recetas.
gws-gmail, gws-drive, gws-calendar, gws-sheets, gws-docs y gws-slides cubren las apps principales, además de Chat, Forms, Keep, Meet y Tasks.
Ayudantes como +send, +reply, +triage, +agenda y +append envían correo, resumen la bandeja, listan reuniones y añaden filas a hojas.
Las skills gws-workflow preparan el informe de la reunión diaria, la próxima cita, convierten un correo en tarea y hacen el resumen semanal.
Las skills persona-* fijan un rol, como asistente de dirección o administrador de TI, y las recipe-* describen operaciones de varios pasos.
Los comandos admiten --dry-run para previsualizar la petición y paginación automática, y cada respuesta llega en JSON.
Cuándo usarla
Cada mañana revisas correo y agenda y quieres que el agente te dé lo no leído y las reuniones del día.
Llevas el control en Google Sheets y quieres que el agente añada filas y monte un informe sin copiar y pegar.
Administras un dominio de Workspace y quieres consultar registros de auditoría e informes de uso desde la terminal.
Pídale al agente
Enséñame los correos sin leer de hoy y mis reuniones antes de comer
Crea en Calendar una reunión de equipo el viernes a las 15:00 y pásame el enlace de Meet
Descarga todo lo de la carpeta de Drive Contratos 2026 y dime qué archivos pasan de 50 MB
Preguntas
¿Cómo conecto las skills de gws a mi agente?
Instala el CLI con npm install -g @googleworkspace/cli o un binario de GitHub Releases, ejecuta gws auth setup y añade las skills con npx skills add. También puedes instalar solo una, como gws-drive.
¿Por qué el inicio de sesión falla con Access blocked?
Añade tu cuenta en Test users dentro de la pantalla de consentimiento OAuth. Una app sin verificar admite además unos 25 permisos como máximo, así que elige servicios con la opción -s.
¿Es gws una herramienta oficial de Google?
No. Está en la organización googleworkspace, pero el README indica que no es un producto con soporte oficial de Google y que habrá cambios incompatibles antes de la v1.0.
