Módulo 3: Google Calendar

Conectar Google Calendar a n8n

Descripción de la cápsula

A estas alturas ya conectaste Google dos veces: Sheets en el Módulo 1, Gmail en el Módulo 2. Google Calendar es la tercera y el flujo te va a resultar familiar — mismo Google, mismo OAuth2, mismo "Sign in with Google".

Esta cápsula es corta a propósito. En lugar de repetir lo que ya sabes, se enfoca en lo específico de Calendar: qué permisos pide, el concepto de múltiples calendarios dentro de una cuenta (algo que no existía en Sheets ni Gmail), y cómo confirmar la conexión creando un evento de prueba.

El objetivo: terminar con una credencial de Calendar funcionando y un evento de prueba en tu agenda.

Lo que vas a aprender

Al terminar esta cápsula serás capaz de:

✅ Crear una credencial de Google Calendar en n8n
✅ Reusar el proyecto de Google Cloud que ya configuraste (self-hosted)
✅ Entender el concepto de "calendarios" dentro de una cuenta
✅ Seleccionar el calendario correcto en el nodo
✅ Crear un evento de prueba para confirmar la conexión

El flujo, que ya conoces

Si hiciste los Módulos 1 y 2, esto es repaso:

n8n → Credentials → Add credential
Busca Google Calendar → selecciona Google Calendar OAuth2 API
Sign in with Google (n8n Cloud) o configura/reusa el proyecto de Google Cloud (self-hosted)
Acepta los permisos
Nombra la credencial claro: Calendar - cuenta negocio

Self-hosted: reusa tu proyecto. Si ya configuraste Google Cloud Console para Sheets o Gmail, no necesitas un proyecto nuevo. Solo entra a ese proyecto y habilita la Google Calendar API (igual que habilitaste la Gmail API en el Módulo 2). Las credenciales OAuth del proyecto sirven para los tres servicios.

Los permisos de Calendar

Google te pedirá permiso para ver, editar, compartir y eliminar permanentemente todos los calendarios a los que tienes acceso. Como con Gmail, si tu proyecto está en modo "Testing" verás la pantalla "Google no ha verificado esta aplicación" — Configuración avanzada → continuar. Es tu propia app accediendo a tu propia cuenta.

El concepto nuevo: una cuenta, varios calendarios

Aquí está lo único realmente distinto de Calendar.

En Sheets, una cuenta tiene muchos documentos. En Gmail, una cuenta tiene una bandeja. En Calendar, una cuenta tiene varios calendarios — y esto importa para los workflows.

Cuando abres Google Calendar, en la barra lateral ves una lista: tu calendario principal, quizás uno de "Cumpleaños", uno de "Festivos", calendarios que otras personas compartieron contigo, calendarios que creaste para proyectos. Cada uno es un calendario separado.

Por qué importa

Cuando el nodo de n8n crea un evento, tiene que saber en cuál calendario. El nodo te pide elegir:

Calendar: el selector donde eliges el calendario destino

El más común es tu calendario principal (suele aparecer con tu dirección de correo como nombre, o como primary). Pero podrías querer un calendario dedicado:

Buena práctica: considera crear un calendario aparte para las automatizaciones — Agenda automatizada o Citas n8n. Así los eventos que genera el workflow no se mezclan con tu agenda personal, y puedes compartir solo ese calendario con tu equipo, o borrarlo entero si algo sale mal. Para empezar, el calendario principal está bien; tenlo en mente para producción.

Confirmar la conexión: crear un evento de prueba

Paso 1: el workflow

Workflow nuevo → Manual Trigger
Agrega un nodo Google Calendar
Credential: la que acabas de crear

Paso 2: configurar

Resource: Event
Operation: Create
Calendar: elige tu calendario (principal, o el que prefieras para pruebas)
Start: una fecha y hora — por ejemplo mañana a las 10:00
End: una hora después
Summary (título): Prueba desde n8n

Paso 3: ejecutar

Click en Test step. Luego abre calendar.google.com y busca el evento mañana a las 10:00.

Si está ahí: la conexión funciona.

Mira con atención a qué hora quedó el evento. Si lo pusiste "a las 10:00" y aparece a las 10:00 — perfecto. Si aparece a otra hora (4:00, 16:00), tienes un tema de zona horaria — exactamente lo que cubre la cápsula 06. No te preocupes ahora; solo nótalo.

Trampas comunes

Trampa 1: No habilitar la Google Calendar API

Qué pasa: En self-hosted, la credencial conecta pero el nodo falla con un error de API.

Cómo evitar: En Google Cloud Console, habilita la Google Calendar API en tu proyecto. Es un toggle aparte de las credenciales — igual que con Gmail.

Trampa 2: Crear el evento en el calendario equivocado

Qué pasa: El workflow "no crea nada" — en realidad lo creó, pero en un calendario que no estás mirando.

Cómo evitar: Verifica el campo Calendar del nodo. Si tienes varios calendarios, asegúrate de elegir el que vas a revisar. Cuando dudes, usa el principal.

Trampa 3: Esperar que la credencial de Gmail/Sheets sirva para Calendar

Qué pasa: Tienes credenciales de Google y crees que cualquiera sirve.

Cómo evitar: Cada servicio de Google tiene su tipo de credencial con sus scopes. Necesitas una credencial Google Calendar OAuth2 API propia — aunque internamente reuse el mismo proyecto de Google Cloud.

Trampa 4: Asustarse con la pantalla de "app no verificada"

Qué pasa: Ves la advertencia y no continúas.

Cómo evitar: Normal para proyectos personales en Testing. Configuración avanzada → continuar.

Ejercicio: conecta y crea

Objetivo: terminar con una credencial de Calendar y un evento de prueba en tu agenda.

Tu tarea

Crea la credencial Google Calendar OAuth2 API en n8n (reusa tu proyecto de Google Cloud si estás en self-hosted, habilitando la Calendar API)
(Opcional pero recomendado) Crea en Google Calendar un calendario aparte llamado Citas n8n
Construye un workflow: Manual Trigger → Google Calendar (Create)
Crea un evento de prueba para mañana
Ábrelo en calendar.google.com y verifica la hora exacta

Checklist de éxito:

La credencial muestra estado conectado
El nodo lista tus calendarios en el selector
El evento aparece en tu agenda
Anotaste si la hora quedó correcta o desplazada (lo resolverás en la cápsula 06)

Resumen y siguiente paso

Conectar Calendar es el mismo flujo OAuth2 de Sheets y Gmail — en self-hosted, reusa el proyecto de Google Cloud y solo habilita la Calendar API
Concepto nuevo: una cuenta tiene varios calendarios — el nodo te pide elegir en cuál crear el evento
Buena práctica: un calendario dedicado a las automatizaciones, separado del personal
Un evento de prueba confirma la conexión — fíjate en la hora exacta (anticipo del tema de zonas horarias)
4 trampas: no habilitar la API, calendario equivocado, reusar credencial de otro servicio, asustarse con la advertencia

Antes de avanzar deberías poder:

Crear una credencial de Google Calendar
Explicar por qué el nodo pide elegir un calendario
Crear un evento de prueba y encontrarlo en tu agenda

Lo que sigue (cápsula 03):

Ya conectado, vamos directo a la operación estrella de Calendar: crear eventos. Título, horario, invitados, descripción, ubicación — y cómo componer cada campo a partir de los datos que llegan al workflow.

Recursos adicionales

n8n Google Calendar Credentials Docs - Setup de credenciales de Google.
Google Calendar: crear un calendario nuevo - Para el calendario dedicado a automatizaciones.
Google Cloud Console - Donde se habilita la Calendar API (solo self-hosted).

Creado: Mayo 14, 2026 Versión: 1.0

← AnteriorIntroducción al Módulo: Google Calendar Siguiente →Crear Eventos