Google Workspace CLI
Google Workspace (googleworkspace GitHub organization) · Programación
Google Workspace CLI, al que casi todos llaman gws, es una herramienta de línea de comandos gratuita y de código abierto que pone Drive, Gmail, Calendar, Sheets, Docs, Chat y Admin detrás de una única interfaz para que nunca vuelvas a tocar la interfaz web. En lugar de escribir a mano llamadas curl contra la documentación REST, ejecutas un comando y recibes JSON estructurado. Se pensó para dos públicos a la vez: desarrolladores que quieren automatizar Workspace rápido y agentes de IA que necesitan salida legible por máquina y skills ya hechas. Esa división explica muchas cosas.
Acerca de Google Workspace CLI
Qué es Google Workspace CLI
Google Workspace CLI es una herramienta basada en Rust de la organización de GitHub googleworkspace que envuelve todas las API de Google Workspace en un solo binario. Lo ingenioso es que no incluye una lista fija de comandos. Lee el Discovery Service de Google en tiempo de ejecución y construye su superficie de comandos sobre la marcha, así que cuando Google añade un endpoint de API, gws lo recoge sin necesidad de una actualización. La salida es JSON estructurado de forma predeterminada, lo que la hace tan útil para un script o un LLM como para una persona sentada frente a la terminal.
El proyecto apunta a quien vive todo el día en Workspace y quiere dejar de hacer clic por la interfaz web, además de la creciente multitud de desarrolladores que conectan asistentes de IA con herramientas de trabajo cotidianas. Te autenticas una vez con OAuth y luego listas archivos, creas hojas de cálculo, envías mensajes de Chat o extraes eventos de calendario desde un solo shell. También incluye unos 40 skills de agentes de IA, así que un asistente puede gestionar tareas de Workspace sin herramienta personalizada alguna. Nada de código de pegamento.
Una advertencia importante: este no es un producto de Google con soporte oficial. Está en desarrollo activo y los mantenedores avisan de que hay que esperar cambios que rompen la compatibilidad de aquí a la versión 1.0. ¿Debería importarte? Sí, si tus scripts necesitan estabilidad a largo plazo. Tiene licencia Apache-2.0 y necesitas tu propio proyecto de Google Cloud para las credenciales OAuth. Si buscas una herramienta pulida y garantizada estable, esta no lo es. Si quieres una que avance rápido y llegue a todas las API de Workspace, es difícil superarla. Elige tu equilibrio.
Primeros pasos
- Instala Node.js 18 o superior, o descarga un binario precompilado para tu sistema operativo desde la página de GitHub Releases.
- Instala gws con
npm install -g @googleworkspace/clio usa Homebrew en macOS. - Ejecuta
gws auth setuppara recorrer la configuración del proyecto de Google Cloud y las credenciales OAuth. - Inicia sesión con
gws auth loginusando una cuenta de Google con acceso a Workspace. - Prueba un comando real, como listar tus diez archivos de Drive más recientes, y revisa la respuesta JSON.
Información del producto
Un vistazo rápido a los precios, las plataformas compatibles y el rendimiento de Google Workspace CLI.
Ideal para
Los usuarios, tareas y casos de uso en los que esta herramienta encaja mejor.
Usuarios
- Desarrolladores que automatizan tareas de Workspace
- Creadores de agentes de IA
- Administradores de sistemas y personal de TI
Tareas
- Automatizar operaciones con archivos de Drive
- Generar informes en Sheets
- Enviar mensajes de Chat o Gmail desde scripts
Casos de uso
- Integrar Workspace en un pipeline de CI/CD
- Crear un asistente personal que reserve reuniones o archive documentos a petición.
- Administración masiva del espacio de trabajo en muchas cuentas y unidades compartidas.
Funciones clave
Superficie de comandos construida en vivo desde el Discovery Service
La CLI no codifica los comandos de forma fija. Lee el Discovery Service de Google en tiempo de ejecución, así que cada endpoint y método de la API de Workspace queda disponible como comando de forma automática. Cuando Google publica un endpoint nuevo, lo tienes sin esperar a un lanzamiento de gws. Eso es lo que mantiene la herramienta al día de una forma que los wrappers estáticos no logran. Así de simple.
Salida JSON estructurada para agentes
Cada respuesta vuelve como JSON estructurado. Para las personas eso significa una salida predecible y analizable que puedes canalizar a jq o a un script. Para los agentes de IA, significa que un LLM puede leer y actuar sobre los datos de Workspace sin ningún código de pegamento. Esta es la razón central por la que la herramienta se vende tanto a desarrolladores de agentes como a personas. La salida se mantiene limpia.
Skills de agentes de IA incluidas
Unas 40 skills de agente vienen con el proyecto y cubren los flujos de trabajo más comunes de Workspace. En lugar de escribir definiciones de herramientas desde cero, puedes colocarlas en un agente y dejar que se encargue de tareas de Drive, Gmail o Calendar. Acorta el camino de "tengo un LLM" a "mi LLM puede gestionar mi Workspace". Un gran atajo.
Ayuda integrada, simulaciones y paginación automática
Cada recurso admite --help, así que puedes explorar comandos sin salir de la terminal. El indicador --dry-run previsualiza la petición antes de que salga, algo útil cuando estás aprendiendo un endpoint que no conoces. La paginación automática se encarga de los conjuntos de resultados grandes, así que no tienes que escribir lógica de bucles para recorrer cientos de archivos de Drive o mensajes de Gmail lote a lote.
Una interfaz para todos los servicios de Workspace
Drive, Gmail, Calendar, Sheets, Docs, Chat y Admin viven tras la misma estructura de comandos. Aprendes el patrón una vez y lo aplicas en todas partes, lo que reduce el cambio de contexto que trae malabarear SDKs separados. Un solo inicio de sesión cubre toda la superficie. De eso se trata.
Opciones de instalación multiplataforma
Puedes instalar gws mediante npm, Homebrew, Cargo o un flake de Nix, o simplemente descargar un binario precompilado para tu sistema operativo. Esa flexibilidad hace que encaje en casi cualquier entorno de desarrollo, ya sea un portátil Mac, un servidor Linux o una máquina Windows.
Ventajas y desventajas
Ventajas
- Gratis y de código abierto bajo Apache-2.0, sin niveles de pago de los que preocuparse.
- Cubre todas las API de Google Workspace a través de una interfaz consistente.
- La integración con el Discovery Service en vivo mantiene actualizado el conjunto de comandos, lo que facilita mantener la automatización de Google Workspace.
- La salida JSON y las skills de agente incluidas lo hacen de verdad útil para flujos de trabajo con agentes de IA.
- Varias vías de instalación (npm, Homebrew, Cargo, Nix, binarios precompilados) encajan casi en cualquier configuración.
Desventajas
- No es un producto de Google con soporte oficial, así que no hay una promesa formal de soporte de Google.
- Se esperan cambios que rompen la compatibilidad antes de la versión 1.0, lo que significa que los scripts pueden necesitar actualizaciones tras los lanzamientos.
- La configuración exige tu propio proyecto de Google Cloud y la configuración OAuth, un obstáculo real para quienes no son desarrolladores.
Preguntas frecuentes
Sí. Es de código abierto bajo la licencia Apache-2.0 y no cuesta nada. Necesitas una cuenta de Google y, para OAuth, un proyecto de Google Cloud, pero ninguno de los dos tiene coste para un uso personal o de desarrollador típico.
Contenido relacionado
Explora herramientas, habilidades y artículos relacionados con Google Workspace CLI.
Alternativas a Google Workspace CLI
Codeflying
Kuafu Technology (Codeflying) · Programación · Marketing · ChatbotCodeflying es un creador de apps con IA que convierte una descripción en lenguaje natural en una web, una app móvil o una mini app que funcionan. Trabaja como creador de apps sin código, así que escribes lo que quieres y un equipo de agentes de IA se encarga de los requisitos, la arquitectura, las pantallas de front-end, la lógica de back-end y el despliegue. El objetivo es sencillo: crear una app desde un prompt, incluso sin experiencia en programación. También incluye herramientas de marketing y un agente de chat para clientes, así que el resultado es más que un prototipo olvidado en un disco duro.
Runware
Runware, Inc. · Imagen · Vídeo · ProgramaciónRunware es una plataforma de inferencia de IA generativa que da a los desarrolladores una sola API para modelos de imagen, vídeo, audio, 3D y lenguaje. En lugar de registrarte en una docena de proveedores, llamas a un único endpoint, cambias de modelo con una línea de código y pagas solo por las peticiones que envías. No hay servidores que mantener. Está pensada para equipos que quieren lanzar funciones de IA rápido sin montar ni cuidar su propia infraestructura de GPU.
Aider
Aider AI LLC · ProgramaciónAider es una herramienta de programación en pareja con IA de código abierto que vive en tu terminal. La apuntas a un repositorio git local, describes lo que quieres en lenguaje natural y ella edita los archivos, escribe los diffs y registra los cambios por ti. Se conecta a Claude, GPT, DeepSeek y Gemini mediante tus propias claves de API, y también ejecuta modelos locales a través de Ollama o cualquier endpoint compatible con OpenAI. Los desarrolladores que ya trabajan en la línea de comandos suelen adoptarla rápido. No estorba. Ahí está todo su atractivo.