lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

skill principiante automationclaude-codeclaude-coworkagentesherramientasdesarrollo

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

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.


Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Comprueba Node.js ≥22.20.0 y npm/npx para la secuencia completa: la CLI principal pide ≥18, pero la instalación posterior de skills exige ≥22.20.0 según su manifiesto. Para gws auth setup, comprueba además que gcloud está instalado y autenticado; si no lo tienes, sigue la ruta manual de OAuth del README. Comandos del README:

npm install -g @googleworkspace/cli

Configura OAuth según la guía; el asistente requiere gcloud:

gws auth setup
gws auth login

Instala las skills con:

npx skills add https://github.com/googleworkspace/cli

Comprobación

Prueba una lectura documentada:

gws drive files list --params '{"pageSize": 5}'

Si algo falla

Revisa permisos, API habilitadas y el procedimiento manual de OAuth del README.

ver en .md ¿Prefieres el recurso entero?

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