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
TypeScriptMITCreated 2025-06-07www.n8n-mcp.com/
More from this author
Download: Release v2.102.0Release-2.102.0 ↓2.102.02026-11-09
+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

Discussions

Latest release

Release v2.102.0 v2.102.0 2026-11-09
Release 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON