Guía Completa para Configurar n8n en Local y Conectar Gmail

Si estás cansado de hacer tareas repetitivas como revisar correos, descargar adjuntos o actualizar bases de datos manualmente, n8n puede ser tu nuevo mejor amigo. Es una herramienta de automatización de código abierto que te permite conectar aplicaciones sin escribir una sola línea de código (bueno, casi).

En esta guía, vamos a ver cómo instalar n8n en local y configurarlo para recibir correos de Gmail de forma automática. ¡Manos a la obra!

¿Qué es n8n y por qué deberías usarlo?

n8n es una plataforma que te permite crear flujos de trabajo automatizados. ¿Qué significa esto? Básicamente, puedes hacer que Gmail, Slack, Google Sheets, APIs y bases de datos trabajen juntos sin intervención manual.

Ejemplo práctico: Automatización de Correos en Gmail

Imagina que trabajas en soporte técnico y recibes muchos correos con archivos adjuntos. En lugar de perder tiempo revisándolos uno por uno, con n8n puedes hacer que:

Detecte nuevos correos en Gmail.
Extraiga información del asunto y cuerpo del correo.
Descargue los archivos adjuntos automáticamente.
Envíe una notificación en Slack o guarde los datos en Google Sheets.

¿Interesante, cierto? Vamos a configurarlo paso a paso.

1. Instalación de n8n en Local

Antes de comenzar, necesitamos instalar n8n en nuestro equipo.

Instalación con npm (Ideal para desarrollo)

Si ya tienes Node.js instalado, simplemente abre una terminal y ejecuta:

npm install -g n8n

Para iniciar n8n, usa:

n8n

Esto abrirá la interfaz de n8n en http://localhost:5678/. Fácil, ¿no?

Verificando la instalación y haciendo pruebas

Verifica que está bien instalado: Ejecuta n8n -v y revisa que aparezca la versión correcta.
Abre n8n en tu navegador: Ingresa a http://localhost:5678/.
Crea un flujo de prueba: Agrega un nodo Start y otro nodo Set para probar cómo funciona.
Ejecuta el flujo: Si todo está bien, debería procesarse sin errores.

2. Configuración de Gmail como Trigger en n8n

Ahora que tenemos n8n corriendo, vamos a conectarlo con Gmail para que detecte automáticamente nuevos correos.

Paso 1: Crear un Proyecto en Google Cloud

Para que n8n pueda leer correos de Gmail, necesitamos obtener un Client ID y Client Secret desde Google Cloud.

Ve a Google Cloud Console.
Crea un nuevo proyecto llamado n8n Gmail Integration.
Habilita la Gmail API en API & Services → Library.
Ve a API & Services → Credentials y crea credenciales OAuth 2.0.
Configura la pantalla de consentimiento OAuth como Externa.
En Authorized redirect URIs, agrega:http://localhost:5678/rest/oauth2-credential/callback
Guarda los valores de Client ID y Client Secret.

Paso 2: Conectar Gmail en n8n

En n8n, agrega un nodo Gmail Trigger.
En Credenciales, selecciona Add New → Gmail OAuth2 API.
Introduce el Client ID y Client Secret de Google Cloud.
Usa este Scope:https://mail.google.com/
Guarda y haz clic en Connect Account.

Paso 3: Permitir el Acceso

Si Google te muestra una advertencia de seguridad:

Haz clic en Advanced → Go to (App Name).
Autoriza el acceso.

Si ves el error Access blocked: n8n Gmail has not completed the Google verification process, ve a Google Cloud Console y agrega tu cuenta en Test Users dentro de la pantalla de consentimiento OAuth.

Paso 4: Configurar el Trigger

Dentro del nodo Gmail Trigger, usa estas opciones:

Trigger On: New Email
Mailbox: INBOX
Format: Metadata and Attachments
Include Attachments: Yes

Ejecuta el nodo y envía un correo de prueba a tu cuenta para asegurarte de que todo está funcionando.

Posible error al probar la integración

Si al ejecutar el nodo en n8n recibes un error con el código 403 (PERMISSION_DENIED) y un mensaje similar a:

«Gmail API has not been used in project before or it is disabled. Enable it by visiting Google Cloud Console.»

Esto significa que la Gmail API no está habilitada en tu proyecto de Google Cloud. Para solucionarlo:

Habilita la API en Google Cloud:
- Visita este enlace: Habilitar Gmail API
- Asegúrate de estar en el proyecto correcto y haz clic en Enable.
Verifica las credenciales OAuth:
- Ve a API & Services → Credentials
- Revisa que las credenciales OAuth estén configuradas correctamente.
Elimina y vuelve a conectar tu cuenta en n8n:
- Abre el nodo Gmail Trigger.
- Elimina las credenciales y agrégalas nuevamente.
Revisa los permisos en IAM & Admin:
- Ve a IAM & Admin
- Asegúrate de que tu cuenta tenga el rol Editor o Owner en el proyecto.
Espera unos minutos y vuelve a probar.

Conclusión

¡Listo! Ahora tienes n8n funcionando en local y conectado con Gmail para recibir correos automáticamente. Desde aquí, puedes hacer que descargue adjuntos, envíe respuestas automáticas o almacene datos en una base de datos.

Si tienes dudas, comenta y lo resolvemos juntos. ¡A seguir automatizando! 😎

mgaribellor