czlonkowski /n8n-mcp
MCP server that lets Claude, ChatGPT, Cursor and other AI assistants operate n8n: debug, edit, validate, test and build workflows on any n8n instance
★ 23,256⑂ 3,679👁 154⑃ 696● 451▤ 316
More from this author
+4
Daily
+60
Weekly
+201
Monthly
23,256
stars
3,679
forks
154
watchers
696
prs
451
issues
316
releases
README
n8n-MCP n8n-MCP is an open-source MCP server that lets Claude, ChatGPT, Cursor, and other AI assistants operate n8n: read failed executions, edit workflows in place, validate and test them, manage credentials, and build new workflows. It works with any n8n instance that has the Public API enabled, and can use n8n's built-in MCP server as a second backend. What You Can Do With It - Debug failing workflows - n8n_executions reads an execution and, with mode: "error", returns the error, the failing node, and sample items from the node before it. - Edit workflows in place - n8n_update_partial_workflow applies targeted operations to the nodes and connections named in the request, so the assistant does not resend the whole workflow. This includes find-and-replace inside one large field such as a Code node (patchNodeField). By default n8n-MCP saves a snapshot before it changes a workflow's nodes or connections, and n8n_workflow_versions can diff and roll back. - Validate and fix before going live - validate_node, validate_workflow, and n8n_validate_workflow report unknown nodes, invalid node versions, missing required fields, and broken connections or expressions. n8n_autofix_workflow repairs the common ones. - Test - n8n_test_workflow runs a workflow through its webhook, form, or chat trigger, or, through n8n's built-in MCP server, with pinned data when it has no such trigger. - Manage the instance - create, update, and delete credentials, work with data tables and folders, and run a security audit (n8n_audit_instance). - Build new workflows - bundled knowledge of 3,501 nodes and 2,352 templates, so the assistant configures real nodes instead of guessing. - Work across several n8n instances - on the hosted service, register production, staging, and client instances once and name the target on each call. Self-hosted HTTP mode can serve several instances with per-request instance headers. n8n-MCP and n8n's Built-In MCP Server n8n ships its own instance-level MCP server, and it covers a lot: building and editing workflows, executions, version history, data tables, and Agents. n8n-MCP does not replace it. The two differ in how they are built: | | n8n's built-in MCP server | n8n-MCP | |---|---|---| | Runs | Inside one n8n instance | As a separate server that talks to n8n | | Instances per connection | One | Several (hosted service, or multi-tenant HTTP mode) | | Credentials | Lists credentials and edits their descriptions | Creates, updates, and deletes credentials | | n8n versions | Present since late n8n 1.x; most tools need n8n 2.12 or later, and each tool has its own minimum version | Workflow and execution tools work through the Public API on older versions too, including the 1.x line. Credential actions depend on what that version's API exposes, and newer tools state the version they need | | Workflow access | Most operations need the workflow's "Available in MCP" setting, which is off by default | Every workflow the API key can reach
Top issues
#832SSRF and private IP ranges6 comments · 2026-06-04#834n8n_get_execution does not respond5 comments · 2026-06-05#904feat: public validation benchmark — reproducible probe suite (announced in #900)4 comments · 2026-07-02#401Feature Request: Enhanced n8n API Coverage (Credentials, Tags, Users, Retry, etc.)4 comments · 2025-11-05#35Feature Request: Restrict to Folder or workflow id's4 comments · 2025-07-11#903chore: dependency security audit on the default branch2 comments · 2026-07-02#762Enhancement: Prioritize built-in Crypto node over Code node scripts for cryptographic operations3 comments · 2026-04-29#549Request: Version compatibility documentation (n8n-mcp ↔ n8n instance versions & editions)3 comments · 2026-01-22
Discussions
#1180n8n-mcp is #3 in MCP servers for developers on Archestack (badge, if you want it)0 comments · 2026-10-21#1055A public record of n8n-mcp's tool definitions over time1 comments · 2026-09-02#900Where n8n-mcp goes from here — now that n8n ships its own MCP server2 comments · 2026-07-02#881Should n8n-MCP clients re-check trust if read-only/management scope changes?2 comments · 2026-06-25#854Is this project obsolete now that n8n has an official MCP tool?0 comments · 2026-06-20#722How to add missing nodes to MCP1 comments · 2026-04-10#671How does your project compare to the official N8N skills?1 comments · 2026-03-27#648Openclaw....2 comments · 2026-03-18
Latest release
Release v2.102.0 v2.102.0 2026-11-09Release v2.102.0 Generating release notes from v2.101.4 to HEAD 🔧 Maintenance - Update n8n to 2.46.7 and bump version to 2.102.0 (f9c69ed) --- Release Statistics: - 1 commit - 1 contributor - Contributors: czlonkowski --- Installation NPM Package bash Install globally npm install -g n8n-mcp Or run directly npx n8n-mcp Docker bash Standard image docker run -p 3000:3000 ghcr.io/czlonkowski/n8n-mcp:v2.102.0 Railway optimized docker run -p 3000:3000 ghcr.io/czlonkowski/n8n-mcp-railway:v2.102.0 Documentation - Installation Guide - Docker Deployment - n8n Integration - Complete