Claude Code n8n: Build Workflows in 10 Min (2026 Guide)

Claude Code n8n workflow automation connects Anthropic's Claude Code CLI to n8n's workflow engine through the Model Context Protocol (MCP). Claude Code in MCP mode has live read/write access to your n8n instance. It can create workflows, configure nodes, set triggers, run tests, and iterate on errors without you touching the n8n visual editor. Workflows that take 2-4 hours to build manually are produced in under 10 minutes.

THE 2-PHASE MODEL

Claude Code operates in two distinct modes when building n8n workflows. Understanding the difference is the difference between success and frustration.

Phase 1 — MCP Mode. Claude Code connects to your n8n instance via an MCP server. It calls tools like create_workflow, update_workflow, get_workflow, execute_workflow, list_workflows, delete_workflow, and get_execution. In this mode, Claude has live read/write access. It builds nodes one at a time, configures parameters, tests each step, reads error messages, and self-corrects. The workflow appears in your n8n canvas automatically. No copy-paste. No JSON export-import.

Phase 2 — Reasoning Mode. When Claude Code is not connected via MCP (or when generating workflow definitions for later import), it produces structured n8n workflow JSON in its response. You can save this JSON and import it into n8n manually. This mode is useful for generating workflow templates, version-controlled definitions, or when building workflows for a team member's n8n instance. The JSON includes full node configurations, connections, and credential references.

The key insight: MCP mode is faster. Reasoning mode is more portable. Use MCP mode for your own instance. Use reasoning mode when generating workflows for others.

[ STAT ] Workflow build time using Claude Code + n8n MCP drops from 4-12 hours to 15-45 minutes. — Ability.ai, 2026

THE THREE-STEP SETUP

Step 1 — Enable MCP in n8n. Navigate to Settings > Instance-level MCP. Toggle the switch to Enabled. Click Connection Details and select Access Token as your authentication method. Copy the server URL and access token. n8n shows the token only once — store it immediately.

Step 2 — Connect Claude Code. Run this command in your terminal:

claude mcp add n8n-mcp -e MCP_MODE=stdio -e LOG_LEVEL=error -e DISABLE_CONSOLE_OUTPUT=true -e N8N_API_URL=https://your-instance.com -e N8N_API_KEY=your-key -- npx n8n-mcp

Replace the URL and key with your values. Then fully exit Claude Code and restart. A reload is not sufficient — the MCP server will not load until the process restarts completely.

Step 3 — Verify the connection. Start Claude Code and type /mcp. You should see n8n-mcp listed with a green checkmark. If it does not appear, the configuration JSON has an error or the restart did not complete cleanly.

GOTCHA: Claude Code cannot set credentials in n8n. Every API key, OAuth token, and webhook secret must be configured manually in the n8n UI. Claude creates the nodes and wiring. You provide the auth. Budget 5 extra minutes per workflow for credential configuration.

[ TOOL: n8n-mcp npm package ] The n8n-mcp package by czlonkowski has 22K GitHub stars. Run via npx n8n-mcp with MCP_MODE=stdio environment variable. Supports all workflow management tools: list_workflows, get_workflow, create_workflow, update_workflow, delete_workflow, execute_workflow, get_execution.

[ TOOL: n8n Skills repository ] The n8n-skills repo on GitHub teaches Claude Code correct node patterns, expression syntax, validation guidance, and workflow patterns. Install via: /plugin install czlonkowski/n8n-skills

THREE REAL WORKFLOW EXAMPLES

Example 1 — Lead Generation Engine. Prompt Claude: Build an n8n workflow that fires every 4 hours, scrapes Reddit and Twitter for buying-intent keywords, enriches leads with Apify, deduplicates in Google Sheets, and posts new leads to Slack. Claude produces a 7-node workflow: Schedule trigger, HTTP Request nodes for Reddit and Twitter APIs, IF node for intent keyword filtering, Apify enrichment node, Google Sheets dedup and logging, and Slack notification. Build time: 10 minutes with MCP. Manual time: 45 minutes.

Example 2 — AI Newsletter Curator. Prompt Claude: Build a workflow that runs weekly, reads 5 RSS feeds, summarizes each article with AI, checks subscriber preferences in Mem0, ranks articles by relevance per segment, and sends personalized newsletters through Mailchimp. Claude produces an 8-node workflow with RSS nodes, OpenAI summarizer, Mem0 preference lookup, ranking AI node, and Mailchimp campaign creator. Build time: 15 minutes with MCP. Manual time: 90 minutes.

Example 3 — Support Ticket Router. Prompt Claude: Build a workflow that receives Intercom tickets, classifies urgency P1-P4 with AI, routes to the right team Slack channel, logs to Google Sheets, and updates the ticket in Intercom with classification tags. Claude produces a 7-node workflow: Webhook trigger, data extraction, AI classification node, Switch router, Slack notifications per path, Google Sheets logger, Intercom updater. Build time: 12 minutes with MCP. Manual time: 60 minutes.

[ STAT ] n8n supports 500+ native integration nodes. Claude Code selects from existing integrations rather than constructing custom ones — confirmed by n8n's node library including email, RSS, Slack, and HTTP Request nodes. — n8n Official Documentation, 2026

THE CRITICAL GOTCHA: CREDENTIALS

The single most common failure point is credential configuration. Claude Code MCP cannot write to n8n's credential store. When Claude creates a Google Sheets node, it adds the node with a reference to a credential ID that does not yet exist. The workflow will fail on execution until you:

Open n8n UI
Navigate to Credentials
Create each credential manually (Google OAuth, Slack token, Apify key, etc.)
Note the credential ID generated by n8n
Update the workflow nodes to reference the correct credential IDs

Alex Fraser of AI Systems Lab identifies this as the most frequently reported issue from early adopters. The fix: configure all credentials in n8n before prompting Claude to build the workflow. Claude can then reference pre-existing credential IDs in its node configurations.

Three more gotchas to know:

GOTCHA 1: The n8n MCP server will not load until the instance is fully restarted. A stop-start is required, not a reload. First-time users commonly report MCP server not found for this reason.

GOTCHA 2: API tokens generated in n8n are shown only once. If you close the dialog without copying the token, you must generate a new one. Store tokens in a password manager immediately.

GOTCHA 3: n8n webhook triggers have a 5-second timeout. When using webhooks, the n8n workflow must return a 200 OK response within 5 seconds before processing the payload asynchronously. Add a Webhook Response node as the first node in the workflow.

ROI: WHAT THE NUMBERS SAY

Workflow build time: 4-12 hours manual to 15-45 minutes with Claude Code MCP (Ability.ai, 2026).
Iteration cycles: 3-4 manual rebuilds to 1 prompt refinement.
Debug time: 1-2 hours visual debugging to 5 minutes reading Claude-generated node comments.
Workflow complexity: 5-8 node workflows manually to 12-15 node workflows with AI assistance.
First-7-day win: First working workflow deployed within 30 minutes of Claude Code installation.

WHAT THIS CANNOT DO

(critical) Claude Code cannot set credentials. All API keys must be configured in n8n UI manually. This is not a minor limitation — it is the single biggest friction point reported by users.
(moderate) Canvas layout generated by Claude is functional but visually messy. Node positions are auto-calculated and may overlap. Works fine for execution but is hard to read for humans.
(moderate) Claude does not understand your specific data schemas. Google Sheet column names, CRM field mappings, and API payload structures need explicit description in your prompt.
(minor) Advanced n8n expressions with nested functions sometimes need manual fixes. Claude understands standard expressions but complex date math or aggregation functions may produce errors.

START IN 10 MINUTES

(2 min) Sign up at n8n.io/cloud or run npx n8n locally. Navigate to Settings > Instance-level MCP and toggle it on.
(3 min) Generate an access token. Copy the server URL and token. Run claude mcp add n8n-mcp with your credentials. Fully restart Claude Code.
(2 min) Run /mcp in Claude Code and confirm n8n-mcp shows a green checkmark.
(3 min) Prompt Claude: Use n8n-mcp to build me a workflow that fires daily at 9am, fetches the weather for Toronto, and emails me the forecast. Wait 30 seconds. Check your n8n canvas — the workflow appears with all nodes wired.

[ STAT ] The n8n-mcp npm package supports all workflow operations via MCP: create, read, update, delete, execute, validate, and list workflows. — czlonkowski/n8n-mcp GitHub Repository, 2026

FAQ

Q: What is the Claude Code n8n 2-phase model? A: Claude Code operates in MCP mode (live API read/write access to n8n) and reasoning mode (structured JSON generation for workflow definitions). MCP mode is used for real-time workflow building. Reasoning mode is used for generating portable workflow templates.

Q: How long does it take to set up Claude Code with n8n? A: The initial setup takes approximately 15-20 minutes including n8n MCP configuration, Claude Code installation, MCP server connection, and credential setup. Subsequent workflow builds take 10-15 minutes per workflow.

Q: Can Claude Code build n8n workflows for cloud-hosted n8n? A: Yes. Cloud-hosted n8n (n8n.cloud) supports MCP access. Enable MCP in Settings > Instance-level MCP and connect via access token. Self-hosted instances require a publicly reachable endpoint for cloud MCP clients.

Q: Does Claude Code work with Make.com or Zapier? A: This guide covers n8n specifically. Claude Code can generate Make.com scenarios via MCP if a Make.com MCP server is available. Zapier does not currently support MCP.

Q: What is the n8n-mcp npm package? A: The n8n-mcp npm package by czlonkowski (22K GitHub stars) is a Model Context Protocol server that exposes n8n's REST API as typed MCP tools. Run it via npx n8n-mcp. No installation required.

Q: How much does Claude Code cost? A: Claude Code usage is billed through your Anthropic API key at standard Claude model rates. n8n MCP access is free. n8n cloud has a free tier with 5 active workflows. Self-hosted n8n is free with no limits.

SOURCES

czlonkowski/n8n-mcp GitHub Repository. 22K stars. Supports all n8n workflow operations via MCP. https://github.com/czlonkowski/n8n-mcp
n8n Official MCP Documentation. Instance-level MCP toggle and access token authentication. https://docs.n8n.io/advanced-ai/mcp/accessing-n8n-mcp-server/
Alex P., AI Systems Lab, April 2026. Claude Code + n8n: The Self-Building Automation Stack Explained. Two-phase model documentation. https://medium.com/ai-systems-lab/claude-code-n8n-the-self-building-automation-stack-explained-31703be7b390
Noah Albert, RoboRhythms, March 2026. How Claude Built My Entire n8n Workflow Automatically. https://www.roborhythms.com/claude-n8n-workflow-2026/
Ability.ai, 2026. Workflow Automation Time Reduction Report. 4-12 hours to 15-45 minutes build time reduction. https://www.ability.ai/blog/claude-code-n8n-workflows
Nate Herk, January 2026. Claude Code is Better at n8n than I am (Beginner's Guide). YouTube tutorial. https://www.youtube.com/watch?v=B6k_vAjndMo