Claude Code + n8n Integration Pattern

A workflow where Claude Code (inside VS Code) uses the n8n MCP server and n8n Skills repo to build, fix, and optimise n8n workflows via natural language. The builder writes a claude.md project file describing the goal, provides the n8n instance URL and API key, and Claude Code plans, creates, validates, and publishes workflows directly. Extends to closed-loop error handling: an n8n error workflow triggers a tunnel (ngrok) to a local Claude Code instance that diagnoses and fixes failures automatically.

Key points

• Stack: VS Code + Claude Code extension + n8n MCP + n8n Skills + n8n API credentials
• Always start in plan mode; only switch to bypass permissions after the plan is approved
• claude.md acts as the project system prompt – it defines folder structure, goals, and safety rules
• Claude Code can fix logic, code, data shape, typos, missing split-outs, and expression syntax errors
• Claude Code cannot fix expired credentials, rate limits, or API outages – escalates those via notification
• Error workflows call Claude Code via an ngrok tunnel because n8n Cloud cannot reach local processes directly
• Workflows with more than ~60 nodes can throttle the n8n API and cause cloud instance timeouts

Related entities

• Claude Code
• n8n
• n8n MCP Server (Community)
• n8n Skills (Claude Code)

Related concepts

• Model Context Protocol (MCP)
• Agentic Workflows
• WAT Framework (Workflows-Agent-Tools)

Source references

• ^[src-005] Nate Herk cluster — Nate Herk — n8n cluster (18 videos)

– Videos referenced: B6k_vAjndMo, OCO3aq3G0mk, uUEa6K-FLB8, ZeJXI2MAhj0