RebundleRebundle Stack
Claude Code Hub

Integraciones · Google Workspace

Conecta Google Workspace a Claude Code

Pega un prompt. Claude te pregunta qué necesitas, instala el CLI gws y te guía paso a paso para conectar tu Gmail, Drive, Sheets, Docs, Slides y Calendar.

Hazlo en el ordenador donde usas Claude Code (no en la web de claude.ai). Iniciarás sesión en Google en tu navegador una vez. Claude empieza en modo solo lectura y nunca te pedirá que pegues una contraseña en el chat.
1

Abre Claude Code

Tú haces esto
  1. 1Abre Claude Desktop
  2. 2Haz clic en la pestaña Claude Code
  3. 3Elige cualquier carpeta para trabajar
2

Pega este prompt

Claude Code

Claude te hará unas preguntas, revisará tu ordenador, instalará lo que falte y te dirá exactamente qué pulsar cuando Google te pida permiso. Solo tienes que seguirle.

dile esto a claude
Quiero conectar mi Google Workspace (Gmail, Drive, Sheets, Docs, Slides, Calendar) a Claude Code para que puedas consultarlo por mí. No soy técnico: guíame paso a paso, un paso cada vez, y espera a que te confirme antes de seguir. CONTEXTO PARA TI - Hay dos vías: 1. El conector nativo de Google de Claude: se activa en los ajustes de Claude, no requiere configuración, enlaza una sola cuenta y sobre todo lee y busca en Gmail y Drive. Lee el texto de un fichero, pero no te da el fichero. 2. El CLI gws (la recomendada para Claude Code): el CLI open-source de Google Workspace (github.com/googleworkspace/cli). Habla con toda la API de Workspace sobre mi propio OAuth: Gmail, Drive, Sheets, Docs, Slides, Calendar, Tasks y más. Permite varias cuentas, descargar ficheros y exportar Docs a PDF, .docx o .xlsx (--output), paginar todos los resultados (--page-all), sacar datos en CSV, tabla o YAML (--format) y escribir (enviar correo, añadir filas, crear eventos) según los scopes que conceda. No es un producto oficial de Google. - Instalación: npm install -g @googleworkspace/cli. En Mac con Homebrew también vale brew install googleworkspace-cli (instala el mismo binario gws). - Login: gws auth login abre el navegador una vez para el OAuth y elijo mi cuenta. Para solo lectura: gws auth login --readonly. Para comprobarlo: gws auth status. Las credenciales se guardan cifradas en ~/.config/gws. - Varias cuentas: un directorio de config por cuenta con la variable GOOGLE_WORKSPACE_CLI_CONFIG_DIR (por ejemplo ~/.config/gws-personal y ~/.config/gws-work), cada una con su propio gws auth login. - Límites: corre en local, así que el CLI tiene que estar instalado en el ordenador donde corres tú. Si la app OAuth está en estado Testing, los tokens caducan cada 7 días; publicar la pantalla de consentimiento a Production evita el re-login semanal. Los comandos de la API llevan parámetros JSON: constrúyelos tú, yo no tengo que aprender la sintaxis. QUÉ QUIERO QUE HAGAS 1. ENTENDER: pregúntame, de una en una y con opciones para elegir: qué quiero conseguir (consultar y buscar, descargar o exportar ficheros, o también escribir: enviar correos, rellenar hojas, crear eventos), qué servicios uso (Gmail, Drive, Sheets, Docs, Slides, Calendar, Tasks) y cuántas cuentas de Google quiero conectar (por ejemplo, la personal y la del trabajo). 2. RECOMENDAR: dime en dos frases qué vía encaja y por qué. Por defecto, gws con login --readonly. Si solo quiero consultas rápidas de Gmail y Drive en el chat, dime que me basta el conector nativo. Solo propón permisos de escritura si necesito escribir. 3. REVISAR: comprueba tú mismo lo que puedas: qué sistema operativo tengo (Mac o Windows) para usar los comandos correctos, si hay npm o Homebrew, si gws ya está instalado y si ya hay una sesión (gws auth status). Instala lo que falte pidiéndome permiso antes. 4. GUIARME EN EL NAVEGADOR: cuando lances gws auth login, dime exactamente qué voy a ver en la pantalla de Google, qué cuenta elegir y qué botón pulsar, un paso cada vez. Si algo no coincide con lo que veo, pídeme una captura de pantalla. Si quiero varias cuentas, repite el login con un GOOGLE_WORKSPACE_CLI_CONFIG_DIR distinto para cada una. 5. CONTRASEÑA: nunca me pidas que te escriba mi contraseña de Google ni ningún código en el chat. El login lo hago yo en el navegador y gws guarda las credenciales cifradas en ~/.config/gws. 6. PROBAR: haz una prueba pequeña de solo lectura (por ejemplo, listar unos pocos correos sin leer o mis próximos eventos del calendario) y enséñame el resultado para confirmar que funciona. 7. RECORDAR: crea una skill personal con cómo usar gws aquí, qué cuentas hay y en qué directorio de config está cada una, los comandos útiles que hayas usado y la regla de que es solo lectura. Así la próxima vez me basta con preguntarte. Reglas: nada de enviar correos, escribir en hojas o documentos, crear eventos ni borrar nada salvo que yo lo pida de forma explícita, y en ese caso enséñame antes exactamente qué vas a enviar o cambiar y espera a mi confirmación. Si algo falla (por ejemplo, la sesión caduca), explícamelo en lenguaje sencillo antes de intentar arreglarlo. CÓMO TRABAJAR CONMIGO - Explícame cada paso como a un niño de 10 años: frases cortas, sin jerga y, si usas una palabra técnica, dime en una línea qué es. Si te digo que soy técnico, ve al grano. - Cuando tengas que preguntarme algo, hazlo de una pregunta en una y con opciones para elegir (usa la herramienta de preguntas con opciones si la tienes), con una línea que explique cada opción. - Si hay que instalar algo, dime en una línea qué es y para qué sirve, y ofrécete a instalarlo tú con mi permiso. Si algo falla, cuéntame en palabras sencillas qué ha pasado y cuál es el siguiente intento, antes de probarlo. - Lo que te cuento arriba puede haberse quedado viejo. Antes de empezar, comprueba en la documentación oficial que sigue vigente; si algo no coincide, manda la documentación y dime qué ha cambiado. - Si tienes navegador (el navegador integrado de la app de Claude o Claude in Chrome), hazlo tú todo lo que puedas en vez de mandarme a una web: ábrela tú, navega hasta la pantalla exacta, rellena lo que no sea secreto y léeme lo que haga falta. Si arriba pone que yo vaya a una página o pulse algo, tómalo como lo que hay que conseguir y hazlo tú con el navegador. Pídeme a mí, de un paso en uno, solo lo que no puedes hacer: iniciar sesión, aprobar permisos, pagar o copiar una clave; tú no escribes contraseñas ni claves en ninguna web. Si no tienes navegador, entonces guíame con instrucciones. - Si hacen falta claves o algo más para conectarte (scripts, configuración), guárdalo en un sitio fijo de mi usuario, fuera de esta carpeta y de cualquier repositorio, que solo yo pueda leer. Nunca en el chat ni dentro de una skill. - La skill de RECORDAR, hazla personal (que funcione desde cualquier carpeta) y apunta en ella: cómo conectarte, con qué cuenta o usuario, dónde están las claves (el sitio, nunca el valor), qué suelo pedirte, las reglas de arriba y la fecha en que comprobaste la documentación. Si algo deja de funcionar porque el servicio cambió, mira la documentación, arréglalo y actualiza la skill. - Mis preferencias y lo que haya fallado van en un LEARNINGS.md aparte, en la misma carpeta de esa skill (una línea por aprendizaje, con fecha y el porqué). El primer paso de la skill es leerlo y aplicarlo. Para que nunca se te olvide proponer aprendizajes nuevos al terminar, añade al frontmatter de su SKILL.md este hook, cambiando <nombre-de-la-skill> por su nombre (inyecta un recordatorio una vez por uso; no lo cambies por un bloqueo, que entra en bucle): hooks: Stop: - hooks: - type: command once: true command: | grep -q '"stop_hook_active":true' && exit 0 echo '{"hookSpecificOutput":{"hookEventName":"Stop","additionalContext":"Antes de terminar: si en este uso de la skill <nombre-de-la-skill> el usuario corrigió algo, algo falló o mostró una preferencia, propón de 0 a 3 aprendizajes para su LEARNINGS.md (fecha, una línea y el porqué), enséñalos y pide OK antes de escribirlos. Si ya propusiste aprendizajes en este turno, no los repitas. Si no hay nada que aprender, termina sin añadir nada."}}'

Después, prueba con estos

Cuando Claude confirme que está conectado, pídele cosas como:

¿Qué correos sin leer de esta semana necesitan respuesta?

Descarga los PDF de las facturas que me llegaron este mes

Lee esta hoja de cálculo y hazme un resumen de los números

¿Qué reuniones tengo mañana y con quién?

El CLI gws en detalle

Lo que el prompt monta por ti, para quien prefiera hacerlo a mano.

gws es el CLI open-source de Google Workspace (github.com/googleworkspace/cli) — un solo comando que habla con toda la API de Workspace sobre tu propio OAuth. Claude Code ya trae un conector nativo de Google, pero solo lee Gmail y Drive. Combina gws con Claude Code y tienes el resto: Sheets, Docs, Slides, Calendar, Tasks, varias cuentas, descarga de ficheros y permisos de escritura. Ojo: no es un producto oficial de Google.

Instala y conecta

Tres comandos. El login abre tu navegador una vez para el OAuth; después Claude Code ejecuta `gws` por ti.

# 1. Instala el CLI (te da el comando `gws`)
npm install -g @googleworkspace/cli

# 2. Autentícate — abre el navegador, elige tu cuenta
gws auth login

# ¿Solo lectura? Pide scopes read-only:
gws auth login --readonly

# 3. Comprueba que funcionó
gws auth status
¿Prefieres Homebrew? brew install googleworkspace-cli también vale (instala el mismo binario gws). Las credenciales se guardan cifradas en ~/.config/gws.

Un CLI, todos los servicios

No las memorizas — le pides a Claude en lenguaje natural y él lanza el comando correcto. Esta es la superficie, con un ejemplo real de cada una.

Gmail

Busca, lee y envía correo; gestiona etiquetas, hilos y borradores.

gws gmail users messages list --params '{"userId":"me","q":"is:unread"}'

Sheets

Lee rangos como CSV, añade filas, actualiza celdas y fórmulas por lotes.

gws sheets +read --spreadsheet <ID> --range Sheet1 --format csv

Docs

Saca el documento completo (texto, títulos, tablas) o añade contenido.

gws docs documents get --params '{"documentId":"<ID>"}'

Slides

Lee el texto y estructura de cada diapositiva, o monta decks por código.

gws slides presentations get --params '{"presentationId":"<ID>"}'

Drive

Lista y busca ficheros en Mi unidad y unidades compartidas; descárgalos o expórtalos.

gws drive files list --params '{"q":"name contains 'invoice'"}'

Calendar

Lista, crea y actualiza eventos en tus calendarios.

gws calendar events list --params '{"calendarId":"primary"}'

Tasks

Lee y gestiona listas de Google Tasks. Además People, Forms, Keep, Meet y Chat.

gws tasks tasks list --params '{"tasklist":"@default"}'

Lo que el conector nativo no puede

Esto es lo que justifica instalar un CLI encima del conector de Google de Claude — las capacidades de abajo sencillamente no están en el conector.

Varias cuentas de Google

El conector enlaza una cuenta. gws guarda un almacén de credenciales cifrado por directorio de config, así que puedes leer el Gmail personal y el del trabajo en paralelo — solo apunta GOOGLE_WORKSPACE_CLI_CONFIG_DIR a una carpeta distinta por cuenta.

# Personal account
GOOGLE_WORKSPACE_CLI_CONFIG_DIR=~/.config/gws-personal gws auth login
# Work account (separate store)
GOOGLE_WORKSPACE_CLI_CONFIG_DIR=~/.config/gws-work gws auth login

Descarga y exporta ficheros (PDF, xlsx…)

El conector lee el texto de un fichero pero no te da el fichero. gws descarga binarios y exporta ficheros nativos de Google a PDF, .docx o .xlsx con --output — así Claude puede coger el PDF real de la factura o exportar un Doc a PDF.

# Export a Google Doc to PDF, saved locally
gws drive files export \
--params '{"fileId":"<ID>","mimeType":"application/pdf"}' \
--output contract.pdf

Permisos de escritura, no solo lectura

Envía correo, añade filas a un sheet, escribe en un doc, crea eventos de calendario. El conector nativo está orientado a leer/buscar; gws hace el CRUD completo — limitado a los scopes OAuth que concediste.

# Append a row to a spreadsheet
gws sheets +append --spreadsheet <ID> \
--range Sheet1 --json '[["2026-06-08", "Paid", 420]]'

Lotes y automatización

Es un CLI: encadena, se automatiza y pagina. --page-all recorre todas las páginas de resultados (NDJSON) — saca 5.000 correos o todos los ficheros de una carpeta de una vez, algo que un conector de chat no aguanta.

# Walk all pages of a Gmail search
gws gmail users messages list \
--params '{"userId":"me","q":"from:stripe"}' --page-all

Salida estructurada (CSV, tabla, YAML)

--format csv|table|yaml|json convierte cualquier respuesta en datos limpios que Claude vuelca directo a un fichero o a un spreadsheet — sin copiar prosa de una burbuja de chat.

Más allá de Gmail y Drive

El conector cubre Gmail y Drive. gws llega además a Sheets, Docs, Slides, Calendar, Tasks, People, Forms, Keep, Meet, Chat e informes de admin — todo Workspace, una sola herramienta.

Capacidades y límites

Qué puede hacer
  • Lectura y escritura completa en Gmail, Drive, Sheets, Docs, Slides, Calendar, Tasks y más.
  • Varias cuentas en paralelo vía directorios de config separados.
  • Descarga binarios y exporta docs nativos a PDF / docx / xlsx.
  • Automatizable: paginación (--page-all), --format csv/yaml, encadenado con otras herramientas.
  • Saneado de contenido opcional (Model Armor) vía --sanitize.
Limitaciones a tener en cuenta
  • No es un producto oficial de Google — mantenido por la comunidad.
  • Los tokens OAuth de una app en estado *Testing* caducan cada 7 días — publica la pantalla de consentimiento a *Production* para evitar el re-login semanal.
  • Corre en local — Claude necesita el CLI instalado en la máquina donde se ejecuta (no en la web de claude.ai).
  • Los verbos crudos de la API usan params JSON; deja que Claude los construya en vez de memorizar la sintaxis.

CLI gws vs. conector de Google de Claude

CLI gwsConector nativo
CuentasVarias (un config dir cada una)Una cuenta enlazada
ServiciosGmail, Drive, Sheets, Docs, Slides, Calendar, Tasks +másGmail + Drive
Lectura / escrituraCRUD completo (según scopes)Sobre todo leer / buscar
Ficheros y PDFsDescarga y exporta (PDF/xlsx/docx)Solo lee texto
AutomatizaciónAutomatizable, paginado, encadenableSolo conversacional
Montajenpm install + login OAuthActivar en ajustes de Claude
SoporteComunidad (no oficial)Integrado en Claude
Mejor paraAutomatización, multicuenta, ficherosConsultas rápidas en el chat

Cómo pensarlo

Son complementarios. Para una consulta rápida en el chat, el conector nativo sobra y no requiere configuración. En cuanto quieras automatización, varias cuentas, descargar ficheros, exportar a CSV o escribir, instala gws — convierte Claude Code en un operador completo de Workspace. Seguridad mínima en ambos casos: empieza con scopes --readonly, y el CLI guarda las credenciales cifradas en ~/.config/gws, nunca en el chat ni en git.

Rebundle · Stack de IA curado