Jonathon's AI Wiki

Building n8n Workflows with Claude Code

6 min read

Source: raw/Claude_Code_is_Better_at_n8n_than_I_am_Beginner_s_Guide.md, raw/Build_ANYTHING_with_Claude_Code_n8n_Beginner_s_Guide.md

Two beginner-friendly walkthroughs from Nate Herk show how Claude Code (in VS Code) becomes the meta-tool for authoring n8n workflows. Instead of dragging nodes around the n8n canvas, you describe what you want in natural language and Claude Code builds, validates, debugs, and edits the workflow directly inside your n8n instance. The bridge has three pillars: the n8n MCP server (live access to your instance + node catalog), the n8n skills repo (expression syntax, validation, code patterns), and a claude.md project file that acts as the system prompt. The same setup also lets Claude Code refactor existing workflows so they can be wrapped by a custom front end.

Key Takeaways

  • Claude Code authors n8n workflows end-to-end. A natural-language brain dump (or a pasted ChatGPT summary of a manual process) becomes a full n8n workflow with schedule trigger, AI agents, tools, and Gmail output in roughly three minutes.
  • Two repos do the heavy lifting. The n8n MCP server gives Claude live access to all 1,100 nodes with 99% property accuracy, 2,700+ workflow templates, and CRUD on your n8n instance. The n8n skills repo ships seven skills — expression syntax, MCP usage, workflow patterns, validation, node configuration, JavaScript, Python — that Claude only loads when needed (token-efficient).
  • claude.md is the project system prompt. A single markdown file in the project folder defines environment, MCP tools, skills, build/validate/deploy steps, and safety rules. Have Claude write it for you in plan mode rather than hand-rolling.
  • Self-correcting build loop. Claude Code creates a to-do list, runs the build, hits errors (e.g. wrong code-node parameters, malformed Slack node config, missing memory session ID), reads its own error output, and patches the workflow. The second video shows it re-resolving a memory session-ID by realizing the webhook body was nested.
  • Plan mode first, bypass-permissions second. Plan mode forces clarification questions (which email? which time zone? which model?) and produces an architecture before any side effects. Switch to bypass-permissions only once the plan is approved.
  • Workflow refactor for front ends. Claude Code can audit an existing n8n workflow and rewire it for a web-app front end: swap form-trigger to webhook, add base64-to-file conversion, add error-output branches, return only the output field instead of the whole JSON body.
  • Limits are real. A 60-node oneshot in n8n cloud throttled the API and bricked the cloud instance for over an hour — self-hosted n8n recovers via reboot, cloud requires a support ticket. Model selection is also imperfect: Claude sometimes picks GPT-4.1 when you asked for GPT-5, or Sonnet 4 when you asked for Sonnet 4.5.

How the Bridge Works

1. The runtime. VS Code with the Claude Code extension is the recommended interface — the terminal works, but the visual file tree, plan-mode toggle, and slash menu make the workflow legible. Open an empty folder as your project; everything Claude builds lives in that folder.

2. The system prompt (claude.md). First action in any new project: have Claude generate claude.md in plan mode. Tell it the goal (“build n8n workflows in my instance using the n8n MCP and n8n skills”), let it ask clarification questions (cloud vs self-hosted, which skills, project structure), then auto-accept its draft. The resulting file covers environment, MCP tools, skills, build → validate → deploy flow, and safety rules. Every later conversation reads this file as context.

3. The two GitHub repos. Paste both repo URLs into Claude Code with “install these for me.” Bypass-permissions mode lets Claude write the .mcp.json config, clone the skills, and prompt only when it genuinely lacks info (your n8n cloud URL and API key). Skills install globally — once done, every future project in this VS Code instance has them. Restart Claude Code so the new MCP server registers.

4. Workflow generation. In plan mode, describe the workflow at the level of intent — “AI agent runs at 7am Eastern, researches AI-automation news for voice-agent niche, formats as HTML newsletter, emails me.” Claude searches the MCP for relevant nodes, asks clarifications (email address, search tool, time zone), builds an architecture plan with configuration details, and on approval creates the workflow directly in your n8n instance. You get a clickable link.

5. Debugging loop. After build, Claude validates against the MCP. If a node config is malformed (wrong parameter name, missing key), it logs the error in its to-do list, reads the schema from the MCP, and patches the workflow. Common failures across both videos: code-node parameters, Slack node config, AI-agent memory session ID nested in webhook body. Each was caught and fixed without human intervention.

6. Migration / refactor. The second video adds the front-end-as-app pattern. Tell Claude to “look at this workflow and optimize it for a custom front end.” It changes form-trigger to webhook, adds base64-to-file conversion for image inputs, swaps HTTP-request error handling to “continue with error output” routed to a separate response branch, and updates every downstream variable reference to match the new input source. The same pattern works to migrate cloud → self-hosted (or vice versa) — let Claude read the workflow JSON, then write it to the new instance via the target MCP.

7. Iteration. Once the workflow exists, you can prompt incremental edits in natural language: “this workflow is great, but switch the response to natural-language only and remove markdown formatting” — Claude updates the AI-agent system prompt inside the n8n workflow without leaving Claude Code.

Try It

  1. Install the prerequisites. Download VS Code, install the Claude Code extension, sign in with your Anthropic account. In Claude Code settings, enable “allow dangerously skip permissions” so bypass-permissions mode is selectable.
  2. Create the project + claude.md. Make an empty folder (e.g. ~/Documents/agentic-workflows/n8n-builder), open it as a folder in VS Code, launch Claude Code, switch to plan mode, and prompt: “Help me create a claude.md file for this project. Goal: build n8n workflows in my instance using the n8n MCP server and n8n skills.” Auto-accept the plan.
  3. Wire up the MCP + skills. Paste the n8n MCP repo URL and the n8n skills repo URL into Claude Code with “install these and make sure Claude Code can use them in this project.” Provide your n8n instance URL (everything before /home) and an API key from n8n Settings → API. Restart Claude Code, then test with: “Search for the webhook node using the MCP.”

Graph View

Backlinks