Google Workspace CLI
CLI de Google Workspace: Herramienta de línea de comandos dinámica para gestionar Drive, Gmail, Calendar y más con IA.
El Google Workspace CLI (gws) es una interfaz de línea de comandos unificada y potente diseñada para administrar todos los servicios de Google Workspace, incluyendo Drive, Gmail, Sheets y Calendar. A diferencia de otras herramientas, gws no utiliza comandos estáticos; en su lugar, consume el Google Discovery Service en tiempo real para generar su superficie de comandos dinámicamente. Esto garantiza compatibilidad inmediata con cualquier nueva función de la API de Google. Está optimizado tanto para usuarios humanos como para agentes de IA, ofreciendo salidas en formato JSON estructurado, soporte para más de 100 habilidades de agentes y una integración nativa con la extensión de Gemini CLI. Con opciones de autenticación flexibles, manejo de paginación automática y comandos simplificados, es la solución definitiva para la automatización profesional de flujos de trabajo en el ecosistema de Google.
2026-03-17
534773.1K
Google Workspace CLI Información del producto
Maximiza tu productividad con el Google Workspace CLI (gws)
En el entorno digital actual, la eficiencia en la gestión de herramientas de colaboración es fundamental. El Google Workspace CLI, conocido técnicamente como gws, surge como la solución definitiva para desarrolladores, administradores de sistemas y agentes de IA que buscan interactuar con el ecosistema de Google de manera ágil y profesional.
¿Qué es Google Workspace CLI?
El Google Workspace CLI es una herramienta de línea de comandos unificada que permite gestionar servicios como Google Drive, Gmail, Google Calendar, Google Sheets, y más, desde una única interfaz. A diferencia de las herramientas tradicionales, el Google Workspace CLI no depende de una lista estática de comandos.
Este software utiliza el Google Discovery Service en tiempo real para construir su superficie de comandos de forma dinámica. Esto significa que cuando Google añade un nuevo endpoint o método a su API, el Google Workspace CLI lo detecta y lo habilita automáticamente, eliminando la necesidad de esperar actualizaciones manuales del paquete.
Características principales del Google Workspace CLI
El Google Workspace CLI ha sido diseñado con un enfoque dual: facilitar la vida de los humanos y potenciar las capacidades de los agentes de IA. Sus características más destacadas incluyen:
- Generación Dinámica de Comandos: Acceso instantáneo a todas las APIs de Google Workspace mediante el Discovery Service.
- Salida JSON Estructurada: Ideal para el procesamiento de datos y la integración con herramientas como
jqo agentes de LLM. - Habilidades para Agentes de IA: Incluye más de 100 Agent Skills y recetas seleccionadas para flujos de trabajo comunes.
- Paginación Automática: Maneja grandes volúmenes de datos con flags como
--page-allpara obtener resultados en formato NDJSON. - Seguridad Robusta: Las credenciales se cifran en reposo (AES-256-GCM) utilizando el llavero del sistema operativo.
- Comandos Especiales (+): Comandos simplificados hechos a mano para tareas frecuentes como
+sendpara correos o+agendapara el calendario. - Soporte Multiplataforma: Disponible mediante npm, Homebrew, Nix o como binarios precompilados.
Cómo usar el Google Workspace CLI
Configurar y utilizar el Google Workspace CLI es un proceso directo diseñado para minimizar la fricción técnica.
Instalación rápida
Para instalar el Google Workspace CLI de forma global en tu sistema, utiliza el gestor de paquetes npm:
npm install -g @googleworkspace/cli
Configuración Inicial y Autenticación
- Setup de autenticación: Ejecuta
gws auth setup. Este comando te guiará en la configuración de tu proyecto en Google Cloud. - Inicio de sesión: Utiliza
gws auth loginpara realizar el flujo de OAuth2 y seleccionar los permisos (scopes) necesarios.
Ejemplos de Comandos Comunes
- Listar archivos en Drive:
gws drive files list --params '{"pageSize": 10}' - Crear una hoja de cálculo:
gws sheets spreadsheets create --json '{"properties": {"title": "Presupuesto 2024"}}' - Enviar un correo electrónico (usando comandos helper):
gws gmail +send --to [email protected] --subject "Hola" --body "Contenido del mensaje"
Casos de Uso del Google Workspace CLI
El Google Workspace CLI es extremadamente versátil y se adapta a diversos escenarios profesionales:
1. Automatización de IT y Administración
Los administradores pueden crear scripts para listar archivos de Drive, auditar permisos o enviar notificaciones masivas a través de Google Chat sin necesidad de escribir código complejo en Python o Node.js.
2. Integración con Agentes de IA
Gracias a su salida JSON y la extensión para Gemini CLI, un agente de IA puede "leer" tu calendario, resumir correos pendientes o generar reportes en Google Docs directamente interactuando con el Google Workspace CLI.
3. Flujos de Trabajo de Desarrollo (CI/CD)
Es posible integrar el CLI en tuberías de CI/CD para subir reportes de construcción a Drive o actualizar hojas de cálculo de estado de despliegue de forma automática mediante Service Accounts.
Preguntas Frecuentes (FAQ)
¿Es este un producto oficial de Google? No, el Google Workspace CLI no es un producto oficialmente soportado por Google, aunque es desarrollado bajo la organización de Google Workspace en GitHub.
¿Cómo manejo el error "Access blocked" durante el login? Este error ocurre usualmente cuando tu aplicación de Google Cloud está en modo de prueba. Debes añadir tu dirección de correo electrónico en la sección de "Test users" dentro de la consola de Google Cloud (OAuth consent screen).
¿Puedo usar el Google Workspace CLI en servidores sin interfaz gráfica?
Sí. El CLI permite exportar credenciales mediante gws auth export y utilizarlas en entornos headless mediante la variable de entorno GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE.
¿Qué servicios son compatibles? Prácticamente todos los servicios que ofrecen una API de Discovery, incluyendo Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin SDK y más.
Nota importante: El proyecto se encuentra en desarrollo activo (v0.x). Se recomienda revisar los cambios en cada versión antes de implementarlo en entornos de producción críticos.
