N8n MCP server
io.github.ratamaha-git/n8n-mcp·v0.3.0·12 starsMCP server for n8n: generate, lint, explain failed executions, drive live n8n via REST.
12 stars94 downloads/wk
Reviews
Write oneNobody has reviewed N8n yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
N8n tools (9, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
n8n_activate_workflowActivate or deactivate a workflow on a live n8n instance (requires N8N_API_URL + N8N_API_KEY). Pass `active: false` to deactivate.
n8n_create_workflowwrite actionCreate a workflow on a live n8n instance (requires N8N_API_URL + N8N_API_KEY). Strips read-only fields (id, active, createdAt, ...) before posting. Workflows are created inactive — call n8n_activate_workflow afterward. Pairs with n8n_generate_workflow for end-to-end 'describe -> deploy'.
n8n_explain_executionDiagnose a failed or surprising n8n execution. Paste the execution JSON (from the n8n UI 'Show details' or `GET /executions/:id?includeData=true`); returns a per-node summary highlighting nodes that returned 0 items, unresolved `={{ ... }}` expressions, errors with hints, and LLM token usage. Hits the most common debugging pain point: items 'silently disappearing' between nodes.
n8n_generate_workflowGenerate a valid n8n workflow JSON from a plain-English description. Handles webhook/schedule/RSS triggers, common action nodes (Slack, Google Sheets, Discord, Gmail, Notion, HTTP), and AI Agent setups (LangChain root agent + chat model + memory + optional HTTP tool, wired with ai_languageModel / ai_memory / ai_tool connections). Returns workflow JSON with unique node IDs, connections, positions,
n8n_get_workflowFetch a single workflow JSON by id from a live n8n instance (requires N8N_API_URL + N8N_API_KEY). Returns the full nodes/connections payload — pair with n8n_lint_workflow to audit a deployed workflow.
n8n_lint_workflowLint an n8n workflow JSON. Returns concrete errors and warnings: missing credentials, deprecated node types (Function -> Code, spreadsheetFile -> convertToFile/extractFromFile), broken connections, missing or non-numeric typeVersion, duplicate node names or IDs, AI Agent missing ai_languageModel sub-node, Webhook missing webhookId, IF node still on v1 condition schema.
n8n_list_executionsList recent executions from a live n8n instance (requires N8N_API_URL + N8N_API_KEY). Filter by workflowId, status (success|error|waiting), limit. Pass `includeData: true` to get the full execution body (large) — pair with n8n_explain_execution to diagnose a specific failure.
n8n_list_workflowsList workflows from a live n8n instance (requires N8N_API_URL + N8N_API_KEY env vars). Returns id, name, active, nodeCount, updatedAt, tags. Filter by active, tags, name. Use this when the user asks 'what workflows do I have?' or before n8n_get_workflow.
n8n_scaffold_nodeScaffold a TypeScript skeleton for an n8n custom node from a plain-English description. Returns a single TypeScript file implementing INodeType with description, credentials reference, and an execute method stub.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan9 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 111 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
How N8n compares
Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 60% of 1,297 Productivity servers
- Tools
- 9
- the typical Productivity server has 7
- Tools that change things
- 11%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 12
- more than 79% of 852 Productivity servers
- Downloads a week
- 94
- more than 55% of 423 Productivity servers with a package
What its tools let an agent do: 8 read · 1 change
Install N8n in Claude Code, Cursor or VS Code
Runs npx -y @automatelab/n8n-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add n8n-mcp -- npx -y @automatelab/n8n-mcp
What the publisher says
From the N8n repository's README, as published. We do not edit it. Read it on GitHub
n8n-mcp
An MCP server for n8n that gives Claude, Cursor, and other AI agents tools for generating workflows, linting, diagnosing failed executions, and driving live n8n instances.
Why we built this
We use n8n daily inside AutomateLab and kept hitting the same LLM failures: workflow JSON that imports but fails at runtime, AI Agent clusters wired with the wrong connection types, executions that silently drop items with no clue where to look. Dumping the whole n8n catalog into context doesn't fix it - the failure modes are too subtle (typeVersion mismatches, IF v1 schema, credentials that don't survive import).
So we built a small, focused server: encode the failure modes the lint can catch, the cluster topology the generator must respect, and the diagnosis the agent can't do alone. For a walkthrough of the nine tools with example output, see the launch post on automatelab.tech.
Why it's different
Other n8n MCP servers (notably czlonkowski/n8n-mcp) compete on breadth - 20+ tools and an indexed corpus of every n8n node. They own that niche.
This server is the debugging-and-first-run-correctness MCP for n8n:
- executionexplain** is the wedge. Paste the execution JSON; get back per-node findings: which nodes returned 0 items, which had unresolved ={{ ... }} expressions, error messages with concrete hints. No other MCP server does this well, and it hits the n8n community's #1 debugging pain point (silent data loss between nodes).
- workflowgenerate is opinionated about AI Agent topology - emits proper LangChain clusters with ailanguageModel / aimemory / aitool connections (sub-nodes connect upward to the agent, not via main). Imports cleanly on n8n 1.x.
- workflowlint** catches the silent failures: deprecated node types (Function → Code, spreadsheetFile → convertToFile), AI Agent missing language model, IF v1 schema, Webhook missing webhookId, broken connections across all connection types (not just main).
- 5 REST tools (gated on N8NAPIURL + N8NAPIKEY) let you list, fetch, create, activate workflows and pull executions - so the lint and explain tools can run against your live workflows, not just JSON pasted in chat.
Plus: a paired Agent Skill that teaches the model when to use which tool and where to load deeper context (split into references/ so it doesn't bloat the prompt).
Tools
Tool names follow dot-notation and form a navigable tree: node., workflow., execution.*. Every tool declares an outputSchema (so callers can type-check responses) and MCP annotations (read-only / destructive / idempotent / open-world hints).
Stateless (work without a live n8n instance):
Live-instance (require N8NAPIURL + N8NAPIKEY env vars):
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
N8n: common questions
- Is N8n MCP server safe?
- Mostly: it is graded B (83/100). Read the N8n safety report
- How do I install N8n?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does N8n need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is N8n maintained?
- The last commit was 147 days ago (2026-06-08). The latest release is v0.3.0.
- What can I use instead of N8n?
- Servers from other publishers that do the same job: Argent MCP server, Obsidian MCP server and gflow-cli MCP server.
- How does N8n compare with other Productivity MCP servers?
- safety score 83/100 (higher than 60% of 1,297 Productivity servers); tools 9 (the typical Productivity server has 7); tools that change things 11% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to N8n
Same job from other publishers: the closest match first, then the best rated.
- ArgentDrive iOS Simulators, Android emulators, TVs and Electron/web apps from your coding agentnot reviewedWidely usedA
- ObsidianMCP server that interacts with Obsidian via the Obsidian rest API community pluginnot reviewedEstablishedA
- gflow-cliDrive Google Flow from an agent: Veo video and Imagen image generationnot reviewedEstablishedA
- Buoy GgLet AI agents read and drive a running React Native or Flutter app through Buoy's devtools.not reviewedEstablishedA
- Unreal EngineEngineWire: drive the Unreal Editor (UE 5.0-5.8): levels, Blueprints, UI, materials, VFX and more.not reviewedEstablishedB