Una CLI que mantiene AI Agent Camp para automatizar Google Workspace. Cubre Gmail, Calendar, Drive, Sheets y Docs con una sola superficie de comandos, accesible desde Claude Code o Cursor en lenguaje natural.

¿Cómo se autentica gog CLI?

Crea un cliente OAuth (tipo Desktop app) en Google Cloud, descarga el JSON, ejecuta gog auth credentials set y luego gog auth add para completar el OAuth en el navegador.

¿Por qué usar gog CLI en un curso de Claude Code / Cursor?

Para que los participantes resuelvan tareas reales de Workspace (clasificar correo, agendar, gestionar archivos) escribiendo prompts en lugar de código cliente de API. Captan la dinámica de la colaboración con el agente en 30 minutos.

¿Por qué el cliente OAuth debe ser Desktop app?

Porque admite el flujo de redirección al navegador local y conserva un refresh token de larga duración. El tipo Web app exige un redirect URI fijo y tokens más cortos, lo que no encaja con un uso CLI.

¿Cómo accedo a los vídeos, slash commands y soporte?

La suscripción a AI Agent Camp habilita los 33 módulos, los slash commands (/setup-gogcli, /module-4-gcp-quick, etc.), el soporte del instructor y la comunidad. 12.800 JPY al mes.

Operar Google Workspace desde Claude Code / Cursor con gog CLI — Guía de Implementación

Publicado: 2026-05-14 · Autor: AI Agent Camp · Lectura: ~20 min

1. Por qué gog CLI

gog reúne las APIs principales de Google Workspace (Gmail / Calendar / Drive / Sheets / Docs) en una sola CLI. Lo desarrollamos para que los alumnos resuelvan tareas reales de Workspace ("resume mis últimos 5 correos", "busca un hueco la próxima semana") desde Claude Code o Cursor en 30 minutos, sin tener que escribir un cliente API en Python o TypeScript.

Un solo agente operando Gmail, Calendar, Drive, Sheets y Docs vía gog

Módulo 4 en un vistazo

Duración ~180 min · 7 lecciones · Herramientas: gogcli / google-workspace-ops / gas-clasp-ops · Tecnología: Google Workspace API / Gemini API

2. Cinco reglas de operación

Nunca subas el JSON del cliente OAuth al repositorio.
Guarda los refresh tokens solo en el directorio local de gog.
Recuerda que el agente hereda tus permisos en Drives compartidos.
Envuelve las acciones destructivas con dry-runs o vistas previas.
Para credenciales de otros usuarios, acuerda con el admin de Workspace y usa Test Users.

3. Arquitectura

Reparto de responsabilidades entre gogcli, google-workspace-ops y gas-clasp-ops

gogcli hace las llamadas directas a las APIs. google-workspace-ops ofrece skills de alto nivel combinando varias llamadas. gas-clasp-ops conecta con Apps Script para automatizar disparos periódicos.

4. Un día típico

Clasificación de correo matinal (faltantes → borradores)
Agenda (búsqueda de huecos → creación de eventos)
Limpieza de Drive (listar → renombrar / mover)
Agregación de Sheets / Excel
Borrador de actas en Docs
Disparadores de GAS para automatizar el día siguiente

5. Configuración de GCP

Crea un proyecto en Cloud Console y vincúlalo a una cuenta de facturación.
Habilita Gmail, Calendar, Drive, Sheets y Docs APIs.
Rellena Branding en Google Auth Platform y mantén la app en modo test.
Añade tu cuenta como Test User.
Crea credenciales OAuth de tipo Desktop app (usuario External).
Descarga el JSON y guárdalo fuera del repositorio.

6. Autenticación de gog

Sesión de terminal gog: versión, registrar credenciales, OAuth, list

# 1. Confirm installation
gog --version

# 2. Register OAuth client
gog auth credentials set credentials/my-google-workspace-oauth.json

# 3. Add account (opens a browser)
gog auth add your-email@example.com

# 4. Check connection
gog auth list

El navegador mostrará la advertencia "Esta app no está verificada". Es lo esperado en modo test: abre "Detalles" y continúa hacia tu app. Aprueba los scopes de Calendar / Gmail / Drive que necesites. En Claude Code / Cursor basta con ejecutar /module-4-gcp-quick y el agente guía los 4 pasos.

7. Prueba de autenticación

# Latest 5 inbox messages
gog gmail search --query "is:inbox" --max 5

# Calendar events for the next 7 days
gog calendar events --days 7

8. Calendar

Flujo de Calendar: huecos libres → creación de eventos

# Find a 60-minute slot in the next 7 working days
gog calendar free-slots --duration 60 --days 7 --working-hours 10-18

# Create an event
gog calendar create-event \
  --title "1on1 @ koheinakamura" \
  --start "2026-05-20T15:00:00+09:00" \
  --duration 30 \
  --attendees "partner@example.com"

9. Triaje de correo

Detección de correos sin respuesta y borradores con Gemini API

10. Drive

Operaciones de Drive: listar / subir / descargar / exportar CSV

# List 20 latest files under a folder
gog drive list --parent <folder-id> --max 20

# Download to local
gog drive download <file-id> --output ./downloads/

# Export Sheets as CSV
gog drive export <sheet-id> --format csv --output ./out.csv

11. Sheets / Excel

# List sheets
gog sheets list <spreadsheet-id>

# Export a range to CSV
gog sheets export <spreadsheet-id> \
  --range "Sheet1!A1:F100" \
  --format csv \
  --output ./out.csv

# Preview first 20 rows
gog sheets preview <spreadsheet-id> --max 20

12. Automatización con GAS

Pipeline disparado por GAS: Drive → Sheets → Notificación a Slack

Descarga el white paper de formación corporativa (gratis)

Te enviamos el PDF que resume el horario del Día 1, las opciones de subvención y el diseño del plan para programas corporativos. Rellena el formulario y nuestro equipo también puede ayudarte a implantarlo en tu empresa.

Si el formulario no carga, escríbenos a kohei@aibrainpartners.jp.

Profundiza con vídeos y la comunidad

La suscripción a AI Agent Camp incluye los vídeos prácticos de cada sección, los slash commands de Claude Code / Cursor, las soluciones a errores comunes, el soporte del instructor y la comunidad. 12.800 JPY al mes.

Ver el curso completo

Preguntas frecuentes

¿Qué es gog CLI?: Una CLI que mantiene AI Agent Camp para automatizar Google Workspace. Cubre Gmail, Calendar, Drive, Sheets y Docs con una sola superficie de comandos, accesible desde Claude Code o Cursor en lenguaje natural.
¿Cómo se autentica gog CLI?: Crea un cliente OAuth (tipo Desktop app) en Google Cloud, descarga el JSON, ejecuta gog auth credentials set <ruta-json> y luego gog auth add <correo> para completar el OAuth en el navegador.
¿Por qué usar gog CLI en un curso de Claude Code / Cursor?: Para que los participantes resuelvan tareas reales de Workspace (clasificar correo, agendar, gestionar archivos) escribiendo prompts en lugar de código cliente de API. Captan la dinámica de la colaboración con el agente en 30 minutos.
¿Por qué el cliente OAuth debe ser Desktop app?: Porque admite el flujo de redirección al navegador local y conserva un refresh token de larga duración. El tipo Web app exige un redirect URI fijo y tokens más cortos, lo que no encaja con un uso CLI.
¿Cómo accedo a los vídeos, slash commands y soporte?: La suscripción a AI Agent Camp habilita los 33 módulos, los slash commands (/setup-gogcli, /module-4-gcp-quick, etc.), el soporte del instructor y la comunidad. 12.800 JPY al mes.