n8n MCP

claude mcp add --transport stdio n8n-mcp -- npx n8n-mcp@latest

n8n es una herramienta de automatización de flujos de trabajo, de código abierto, parecida a Zapier o Make pero que puedes alojar tú. Este MCP conecta a Claude con n8n para que diseñes, configures y valides workflows conversando, en vez de arrastrar y configurar cada nodo a mano. En la práctica, “montar un workflow” pasa a ser una charla con el agente, que conoce los nodos, las expresiones y los patrones comunes de automatización.

Esto importa más de lo que parece. n8n es tremendamente potente, pero tiene una curva de entrada importante: hay cientos de nodos, cada uno con sus parámetros, sus expresiones y sus formas de encadenarse. Aprender la herramienta a fondo lleva semanas, y la mayoría de la gente se queda en una décima parte de lo que puede hacer. Con este MCP el agente actúa como un consultor que conoce la herramienta entera y te ayuda a llegar al patrón correcto sin que tú tengas que memorizar el catálogo.

Conviene tener claro qué hace el MCP y qué no. No ejecuta nada en producción por su cuenta: el flujo es diseño y validación. Tú revisas el workflow propuesto, lo importas a tu instancia de n8n, conectas las credenciales reales y lo activas cuando estás conforme. La frontera entre “el agente piensa con vos” y “el sistema actúa por vos” queda clara.

Qué te abre

Lo más útil es diseñar workflows desde cero a partir de una descripción. Le cuentas al agente qué quieres (“cuando llegue un formulario, guardar los datos en una hoja de cálculo y mandar un correo de aviso”) y él propone la cadena de nodos que lo resuelve, con los parámetros básicos rellenados y los puntos donde tú tendrás que conectar credenciales.

Lo segundo es ajustar flujos existentes. Pegas un workflow que ya tienes y le pides “añade un paso que filtre los formularios que parezcan spam antes de enviarlos a la hoja”. El agente lee la estructura, propone los cambios y te explica dónde y cómo encajan.

La tercera función, menos visible pero muy práctica, es la ayuda con expresiones. n8n usa una sintaxis propia para hacer transformaciones rápidas ({{ $json.campo }} y similares) que pone nerviosa a quien no la usa a diario. El agente puede generar la expresión correcta, explicarte por qué funciona y debugarla cuando no devuelve lo que esperas.

Y por último, valida configuraciones. Tras describir un workflow, le pides “comprueba que esta secuencia tiene sentido”: el agente revisa que los nodos estén bien conectados, que los datos fluyan en el formato correcto y que no haya un paso que vaya a romper la cadena. Es como tener a alguien que mira el flujo antes de activarlo.

Cómo conectarlo

El camino más simple es desde Claude Code. Comprueba que tienes Node.js instalado con node --version (el servidor corre con npx). Después ejecuta el comando que aparece en el frontmatter:

claude mcp add --transport stdio n8n-mcp -- npx n8n-mcp@latest

La sintaxis con --transport stdio indica al cliente que va a hablar con el servidor por entrada/salida estándar, que es lo habitual en los MCP locales. El comando es idéntico en Windows y en Mac. Para confirmar que ha quedado registrado:

claude mcp list

Deberías ver n8n-mcp en la lista. A partir de ahí, cuando le pidas a Claude algo de automatización, podrá usar el servidor para componer el flujo.

Si trabajas en Claude Desktop, el camino pasa por editar claude_desktop_config.json a mano y añadir un bloque dentro de mcpServers con command: "npx" y args apropiados. El resultado es el mismo. Si no tienes claro el flujo general de añadir un MCP, la ficha ¿Qué es un MCP? lo explica paso a paso.

Un punto importante que conviene aclarar: este MCP no necesita conectarse “en vivo” a tu instancia de n8n para diseñar flujos. Lo que produce son archivos de workflow (en el formato JSON que n8n importa) y descripciones de lo que hace cada nodo. El paso de “llevar esto a mi n8n real” lo das tú: importas el JSON desde la interfaz, conectas las credenciales y activas. Esta separación es deliberada y es lo que hace que sea seguro hablar de configuraciones sin tener que dar acceso al sistema real.

Seguridad y permisos

El MCP en sí es bajo en riesgo porque no toca tu instancia de n8n directamente: trabaja sobre descripciones y JSON. Eso significa que la mayor parte de la seguridad está en lo que pasa después, cuando tú importas el flujo a n8n y lo activas.

Las credenciales de cada servicio (correo, hojas de cálculo, APIs externas) se cargan en n8n, no en el chat. Si necesitas referirte a una clave durante el diseño, usa siempre un placeholder como TU_API_KEY; nunca pegues la clave real en la conversación. La regla es la misma para tokens de webhook, contraseñas SMTP y cualquier otro secreto.

Antes de activar un workflow nuevo, revísalo en n8n con la vista del editor: la representación visual a veces revela errores que en JSON pasan inadvertidos. Y empieza siempre con el modo “inactivo” o con un nodo de prueba antes de dejarlo correr de verdad, sobre todo cuando el flujo manda correos a clientes, escribe en bases de datos compartidas o llama a APIs con coste por uso.

Casos de uso reales

Una freelance que gestiona varios clientes quiere unificar la entrada de leads de tres formularios distintos en una sola hoja de cálculo. Le describe la idea al agente, este propone un workflow con un nodo por cada formulario, una normalización de campos y un paso final que escribe en la hoja. Ella importa el JSON, conecta sus credenciales y lo activa en menos de una hora.

Un equipo pequeño usa n8n para notificar al canal de soporte cuando llega un ticket urgente. Tienen el flujo básico pero quieren añadir un filtro inteligente: solo notificar si el contenido del ticket contiene ciertas palabras clave o si el cliente está en su lista de cuentas grandes. Le pegan al agente el workflow actual y le piden el cambio. El agente devuelve el JSON modificado y explica qué hizo.

Una persona poco técnica quiere automatizar una rutina personal: cuando reciba un correo de su gestoría, guardar el adjunto en una carpeta concreta de su nube. Describe la idea sin saber qué nodos usa n8n. El agente le propone la cadena completa con dos servicios estándar y le explica qué credenciales tendrá que conectar.

Errores comunes y cómo evitarlos

• El MCP no aparece en claude mcp list. Suele faltar Node.js o el comando falló al instalar. Repite el claude mcp add con cuidado y mira si hay errores en la salida.
• Workflows que se ven bien en el chat pero no se importan en n8n. A veces el JSON propuesto tiene un campo de más o un nombre de nodo desactualizado. Si la importación falla, pega el error de n8n al agente y suele identificar el problema rápido.
• Confundir el diseño con la ejecución. El MCP describe y propone; no ejecuta tus workflows en producción. Si esperas que “lance” automatizaciones por su cuenta, te llevarás un chasco. La activación la haces tú en n8n.
• Credenciales en el chat. No pegues claves reales en la conversación, ni siquiera como prueba. Usa placeholders y configúralas dentro de n8n, donde están a salvo.
• Activar un workflow sin probarlo. Un nodo mal configurado puede mandar mil correos en bucle o sobrescribir una hoja entera. Prueba siempre con un caso real en modo manual antes de activarlo en vivo.
• Versión del paquete desactualizada. El @latest del comando trae la versión más reciente, pero si llevas tiempo con el MCP instalado y notas comportamientos raros, reinstala para refrescar.

Combinarlo con otros MCPs y skills

n8n MCP encaja bien con el de filesystem (guardar plantillas de workflows en disco y recuperarlas para futuras automatizaciones), con Firecrawl (rastrear webs y meter el resultado en un flujo de n8n para procesarlo) y con el de GitHub (versionar los workflows en un repo, abrir un PR con cada cambio). Para procesos largos que combinan automatización y desarrollo, también se lleva bien con Desktop Commander.

Mini-ejercicio

Instala el MCP y pide al agente “diseña un workflow de n8n que, cuando llegue un nuevo correo con asunto ‘Factura’, guarde el adjunto en una carpeta de Google Drive y me notifique en Slack”. Importa el JSON resultante a una instancia de prueba de n8n. Sabrás que está bien si el flujo se carga sin errores, los nodos están conectados de forma coherente y puedes ver claramente dónde tienes que enchufar tus credenciales para que funcione.