Conectar Gmail, Sheets y Drive a Claude Code

Conectar Google a Claude Code: Gmail, Sheets y Drive

Imagina pedirle a Claude Code que lea tu última hoja de cálculo de ventas, redacte un email con los resultados y lo envíe por Gmail. Todo sin salir de la terminal. Sin copiar datos entre pestañas. Sin abrir el navegador.

Eso es exactamente lo que permite Google Workspace CLI (GWS CLI), una herramienta de línea de comandos publicada por Google que conecta Gmail, Drive, Sheets, Calendar, Docs y Slides en una sola interfaz. Y cuando la combinas con Claude Code, conviertes tu terminal en un centro de operaciones que habla directamente con todo tu ecosistema de Google.

En este artículo te explico qué es GWS CLI, cómo instalarlo, cómo configurar la autenticación paso a paso, y los comandos principales que puedes usar para cada servicio. No necesitas saber programar.

Qué es GWS CLI y por qué importa

GWS CLI es una herramienta de código abierto, desarrollada por Google en Rust y distribuida a través de npm. Su nombre completo es @googleworkspace/cli y actualmente está en la versión 0.22.5, en desarrollo activo hacia la versión 1.0.

Lo que la hace especial es su arquitectura: GWS CLI lee el servicio de descubrimiento de Google en tiempo de ejecución para construir automáticamente todos sus comandos. Esto significa que cuando Google añade una funcionalidad nueva a cualquiera de sus servicios, GWS CLI la incorpora sin necesitar una actualización manual.

En la práctica, esto te da acceso a más de 100 operaciones en Gmail, Drive, Sheets, Calendar, Docs, Slides, Chat y Admin desde una sola herramienta.

Instalación: un solo comando

La instalación es sencilla. Solo necesitas tener Node.js instalado (lo cual ya tienes si usas Claude Code) y ejecutar:

npm install -g @googleworkspace/cli

Esto instala el binario precompilado. No necesitas Rust ni ninguna herramienta extra.

Para verificar que se instaló correctamente:

gws --version

Configurar la autenticación (una sola vez)

Esta es la parte que requiere más paciencia, pero solo la haces una vez. El proceso tiene tres pasos y toma entre 20 y 30 minutos.

Paso 1: Crear un proyecto en Google Cloud

1. Ve a console.cloud.google.com
2. Crea un proyecto nuevo (ponle el nombre que quieras, por ejemplo "Mi Workspace CLI")
3. Activa las APIs que necesites: Gmail API, Google Sheets API, Google Drive API, Google Calendar API

Paso 2: Configurar la pantalla de consentimiento OAuth

1. En el menú lateral, ve a "APIs y servicios" y luego "Pantalla de consentimiento"
2. Selecciona "Externo" como tipo de usuario
3. Completa los campos básicos (nombre de la aplicación, tu email)
4. Añade los ámbitos (scopes) de los servicios que quieras usar

Paso 3: Crear credenciales y autenticar

1. En "Credenciales", crea un ID de cliente OAuth 2.0 de tipo "Aplicación de escritorio"
2. Descarga el archivo JSON con las credenciales
3. En tu terminal, ejecuta:

gws auth login -s drive,gmail,sheets,calendar

Se abrirá una ventana del navegador para completar el flujo de OAuth. Acepta los permisos y listo. Las credenciales quedan guardadas en tu máquina y no necesitas repetir este proceso.

Comandos principales por servicio

Una vez autenticado, estos son los comandos que más usarás. Todos producen salida en formato JSON, lo que los hace ideales para que Claude Code los interprete y procese.

Gmail: enviar, responder y gestionar correo

# Enviar un email
gws gmail +send --to cliente@empresa.com --subject "Propuesta Q2" --body "<p>Adjunto la propuesta actualizada.</p>"
 
# Responder a un hilo existente
gws gmail +reply --message-id ID_DEL_MENSAJE --body "<p>Gracias por confirmar.</p>"
 
# Reenviar un email
gws gmail +forward --message-id ID_DEL_MENSAJE --to colega@empresa.com

El cuerpo del email acepta formato HTML, así que puedes incluir negritas (<b>), cursivas (<i>) y enlaces (<a href>). Claude Code puede componer estos emails por ti a partir de instrucciones en lenguaje natural.

Sheets: leer y escribir hojas de cálculo

# Leer datos de una hoja
gws sheets spreadsheets values get --spreadsheet-id ID_DE_LA_HOJA --range "A1:D10"
 
# Añadir una fila nueva
gws sheets +append --spreadsheet ID_DE_LA_HOJA --values "María García,95,Aprobado"

Esto es particularmente potente combinado con Claude Code. Puedes decirle: "Lee la hoja de ventas de marzo y dime qué producto vendió más". Claude ejecutará el comando, interpretará los datos y te dará la respuesta.

Drive: subir, buscar y organizar archivos

# Subir un archivo
gws drive +upload ./informe-q1.pdf --name "Informe Q1 2026"
 
# Listar archivos recientes
gws drive files list --page-size 10

Calendar: consultar y crear eventos

# Ver próximos eventos
gws calendar events list --calendar-id primary --time-min 2026-04-06T00:00:00Z
 
# Crear un evento
gws calendar events insert --calendar-id primary --summary "Reunión de equipo" --start "2026-04-07T10:00:00" --end "2026-04-07T11:00:00"

Ejemplos prácticos para el día a día

No necesitas ser programador para aprovechar esto. Aquí van escenarios reales donde la combinación de Claude Code y GWS CLI ahorra tiempo.

Resumen semanal automático. Le dices a Claude: "Lee mi calendario de esta semana y crea un resumen en un documento de Google Docs". Claude consulta tus eventos con GWS CLI, redacta el resumen y lo sube a tu Drive.

Seguimiento de clientes. Tienes una hoja de cálculo con contactos y fechas de último contacto. Le pides a Claude: "Revisa la hoja de clientes y envía un email de seguimiento a todos los que no hemos contactado en 30 días". Claude lee la hoja, identifica los contactos, redacta emails personalizados y los envía por Gmail.

Reporte desde datos. Le dices: "Descarga los datos de la hoja de ventas, calcula los totales por región y envíame un email con el resumen". Claude ejecuta todo en secuencia: lee Sheets, procesa los números, compone el email y lo envía.

Gestión de agenda. "Bloquea dos horas mañana para trabajo profundo y envía un aviso al equipo". Claude crea el evento en Calendar y envía el email por Gmail.

GWS CLI frente a los conectores nativos de Google

Si usas Claude en su versión web o de escritorio (claude.ai o Claude Desktop), quizás hayas visto los conectores nativos de Google Workspace. Son integraciones integradas que permiten acceder a Gmail, Calendar y Drive directamente desde la interfaz de Claude. Funcionan en los planes de equipo y empresa.

La diferencia principal es el alcance:

Los conectores nativos son más fáciles de activar, pero GWS CLI te da acceso completo a todas las APIs de Google y la capacidad de encadenar operaciones complejas. Si tu flujo de trabajo vive en la terminal con Claude Code, GWS CLI es la opción más potente.

Consejos para sacar el máximo provecho

1. Configura un CLAUDE.md con tus identificadores. Guarda los IDs de tus hojas de cálculo, calendarios y carpetas de Drive más usados en tu archivo CLAUDE.md. Así no tienes que buscarlos cada vez. Si no sabes qué es CLAUDE.md, lee nuestra guía sobre la diferencia entre Skills y CLAUDE.md.

2. Crea un Skill para tareas repetitivas. Si cada lunes generas el mismo reporte desde Sheets y lo envías por Gmail, convierte ese flujo en un Skill que puedas invocar con un solo comando.

3. Usa direnv para múltiples cuentas. Si manejas varias cuentas de Google (personal y trabajo, por ejemplo), puedes usar variables de entorno por carpeta para que GWS CLI use las credenciales correctas automáticamente según el proyecto en el que estés trabajando.

4. Empieza por leer, después escribe. Antes de pedirle a Claude que envíe emails o modifique hojas de cálculo, practica con comandos de lectura. Lee tu calendario, consulta una hoja, lista archivos de Drive. Cuando te sientas cómodo, pasa a las operaciones de escritura.

Si quieres aprender a conectar Claude Code con otras herramientas de tu flujo de trabajo, revisa también cómo controlar el navegador desde Claude Code y cómo automatizar tareas con programación.

El ecosistema de Google, al alcance de tu terminal

La combinación de Claude Code y GWS CLI convierte una simple ventana de terminal en un asistente que no solo escribe código, sino que gestiona tu correo, lee tus datos y organiza tu agenda. Todo con lenguaje natural.

La configuración inicial requiere algo de paciencia (crear el proyecto en Google Cloud, configurar OAuth), pero es un esfuerzo de una sola vez. Una vez hecho, cada interacción posterior es instantánea.

Lo más relevante para profesionales que no programan: no necesitas memorizar estos comandos. Claude Code los ejecuta por ti. Tu trabajo es describir lo que necesitas en español, y la IA se encarga del resto.

Siguiente lectura: Cómo controlar el navegador con Claude Code | Ver la guía completa