Google Workspace CLI — Conecta AI con Google

El Problema

Todos quieren que su AI lea emails, agende reuniones y busque archivos en Drive. Nadie te dice lo difícil que es conectarlo. Google es el servicio más usado del mundo, pero su sistema de autenticación (OAuth + Google Cloud Console) es la parte más compleja de cualquier setup de asistente AI.

Cada video de YouTube lo confirma: la integración con Google es la parte donde la gente se pierde. Todos los influencers o la saltan o la simplifican tanto que no sirve el tutorial.

Ahora hay una herramienta nueva que no elimina esa complejidad — pero la organiza mucho mejor.

¿Qué es gws?

gws es un CLI open-source que cubre todas las APIs de Google Workspace con un solo comando. Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin — todo. Salió el 2 de marzo 2026 y ya tiene 9,400+ estrellas en GitHub.

Lo interesante es que no tiene una lista fija de comandos. Lee el Discovery Service de Google en runtime y construye su interfaz dinámicamente. Cuando Google agrega un endpoint nuevo, gws lo detecta automáticamente.

Para humanos: no más curl contra REST docs. gws te da --help en cada recurso, --dry-run para preview, y auto-paginación.

Para agentes AI: todo el output es JSON estructurado. Viene con 100+ skills pre-hechos y un MCP server para conectar con Claude Desktop, Gemini CLI o VS Code.

Instalación

Requisitos: Node.js 18+ y un proyecto en Google Cloud (más sobre eso en la sección de auth).

npm install -g @googleworkspace/cli

También puedes descargar binarios pre-compilados desde GitHub Releases o compilar desde fuente con Rust:

cargo install --path .

Autenticación (la parte difícil)

Seamos honestos: la autenticación con Google siempre es compleja. gws ofrece varias formas, pero todas requieren un proyecto en Google Cloud.

gws auth setup     # crea proyecto, habilita APIs, configura OAuth
gws auth login     # login subsecuente

gws auth login --account work@corp.com
gws auth login --account personal@gmail.com

gws auth list                                    # ver cuentas
gws auth default work@corp.com                   # default
gws --account personal@gmail.com drive files list # override temporal

# Máquina con browser
gws auth export --unmasked > credentials.json

# Servidor
export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/credentials.json
gws drive files list   # funciona directo

Comandos Esenciales

# Listar archivos
gws drive files list --params '{"pageSize": 10}'

# Subir archivo
gws drive files create --json '{"name": "report.pdf"}' --upload ./report.pdf

# Paginar todo
gws drive files list --params '{"pageSize": 100}' --page-all | jq -r '.files[].name'

# Listar mensajes
gws gmail users messages list --params '{"userId": "me", "maxResults": 5}'

# Leer un mensaje
gws gmail users messages get --params '{"userId": "me", "id": "MSG_ID"}'

# Eventos de hoy
gws calendar events list --params '{"calendarId": "primary", "timeMin": "2026-03-05T00:00:00Z", "maxResults": 10}'

# Crear spreadsheet
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}'

# Leer celdas (¡single quotes para escapar el !)
gws sheets spreadsheets values get \
--params '{"spreadsheetId": "ID", "range": "Sheet1!A1:C10"}'

# Agregar filas
gws sheets spreadsheets values append \
--params '{"spreadsheetId": "ID", "range": "Sheet1!A1", "valueInputOption": "USER_ENTERED"}' \
--json '{"values": [["Name", "Score"], ["Alice", 95]]}'

# Ver schema de cualquier método
gws schema drive.files.list

# Dry run (preview sin ejecutar)
gws chat spaces messages create \
--params '{"parent": "spaces/xyz"}' \
--json '{"text": "Deploy complete."}' \
--dry-run

MCP Server

gws mcp levanta un servidor Model Context Protocol sobre stdio. Esto le permite a cualquier cliente MCP-compatible — Claude Desktop, Gemini CLI, VS Code — llamar las APIs de Google como herramientas estructuradas.

# Exponer Drive, Gmail y Calendar como tools
gws mcp -s drive,gmail,calendar

Configuración en tu cliente MCP:

{
"mcpServers": {
  "gws": {
    "command": "gws",
    "args": ["mcp", "-s", "drive,gmail,calendar"]
  }
}
}

Agent Skills para OpenClaw

El repo incluye 100+ Agent Skills (SKILL.md files) — uno por cada API soportada, más workflows de alto nivel y 50 recetas curadas para Gmail, Drive, Docs, Calendar y Sheets.

# Todos de golpe
npx skills add https://github.com/googleworkspace/cli

# Solo los que necesitas
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-drive
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail

# Symlink (se mantiene sincronizado con el repo)
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

# O copiar skills específicos
cp -r skills/gws-drive skills/gws-gmail ~/.openclaw/skills/

El skill gws-shared incluye un bloque install para que OpenClaw auto-instale la CLI vía npm si gws no está en el PATH.

La Verdad Sin Filtro

Lo que gws sí resuelve:

• Un solo CLI para todas las APIs (en vez de curl contra 20 REST endpoints diferentes)
• Output JSON estructurado para humanos y agentes
• --help en cada recurso, --dry-run para preview
• Auto-paginación, subida multipart, soporte multi-cuenta
• MCP server listo para Claude, Gemini, VS Code
• 100+ skills pre-hechos para agentes AI

Lo que gws NO resuelve:

Recursos

¿Quieres la guía básica primero? Revisa OpenClaw: La Guía Completa en Español para instalar tu asistente AI antes de conectarlo con Google.