
n8n-mcp
MCP server that lets AI assistants debug, edit, test and build n8n workflows
The repository was last updated yesterday and is published under MIT.
- Pricing
- Open source
- Platforms
- CLI, API, self-hosted
- GitHub stars
- 23.3K
- Last commit
- 1 day ago
- Language
- TypeScript
- License
- MIT
Similar MCP servers
About n8n-mcp
n8n-mcp is an open-source MCP server for developer tools. It is available on CLI, API, self-hosted and Web.
Instead of pasting exported workflow JSON into a chat, n8n-MCP lets an assistant such as Claude, ChatGPT or Cursor read failed executions, edit nodes in place and run tests against an n8n instance. Its tools cover validation, targeted node and connection patches, snapshot-based version rollback, credential management and a security audit of the instance.
The README says the server ships with a bundled database of 3,501 n8n nodes and 2,352 workflow templates, so generated workflows use real node types and parameters. It can connect to several n8n instances through one connection, and it can route operations the public API cannot perform to n8n's built-in MCP server when an instance-level token is set.
The project is aimed at people who maintain n8n automations, including operators with several production, staging or client instances. The open-source server is MIT licensed and can run via npx or Docker, while a hosted service offers OAuth sign-in and a free tier of 100 tool calls per day.
Tools this server provides (8)
Taken from the project documentation; the running server may differ.
- n8n_executions
- List, get and delete n8n executions, including error analysis.
- n8n_update_partial_workflow
- Apply targeted diff operations to a workflow's nodes and connections.
- n8n_workflow_versions
- List, diff and roll back workflow version snapshots.
- n8n_validate_workflow
- Validate a workflow in n8n by ID.
- n8n_autofix_workflow
- Automatically fix common workflow errors.
- n8n_test_workflow
- Run a workflow through its trigger or n8n's native MCP server.
- n8n_manage_credentials
- List, get, create, update, delete and schema-read n8n credentials.
- n8n_audit_instance
- Run a security audit of an n8n instance.
What it does
- Execution error analysis
- Reads a failed execution and returns the error, the failing node and sample items from the node before it.
- Targeted workflow edits
- Applies patch operations to named nodes and connections so the whole workflow does not need to be resent.
- Snapshots and rollback
- Saves a version before changing nodes or connections and can diff and roll back saved versions.
- Validation and autofix
- Flags unknown nodes, invalid versions, missing required fields and broken connections, and repairs common issues.
- Multi-instance connection
- Registers several n8n instances once and lets each call name its target instance.
- Credential and data table management
- Creates, updates and deletes credentials, and manages data tables, folders and variables.
Good for
- Diagnosing why a production n8n workflow failed without copying error logs by hand
- Editing a large Code node or a set of connections through an AI assistant
- Checking health or making changes across several client n8n instances from one chat
- Building new n8n workflows that use real node configurations instead of guessed parameters
- Running a security audit on an n8n instance
Pricing
Open source
Open-source MIT server free to self-host; hosted service has a free tier and a Supporter plan.
Prices change. Check n8n-mcp.com before you buy.
n8n-mcp FAQ
Is n8n-mcp free to use?
The open-source server is MIT licensed and free, with no quotas or account needed. The hosted service has a free tier of 100 tool calls per day and a Supporter plan with unlimited tool calls subject to a fair-use cap of 5,000 per day.
Does it work with older n8n versions?
The README says the workflow and execution tools work through the public API on older versions, including the 1.x line. Credential actions depend on what that version's API exposes.
Does it need the n8n built-in MCP server?
No. The README says it can use n8n's built-in MCP server as a second backend for features such as pinned-data test runs, native version history and live dropdowns, which require an instance-level MCP token.
Is my n8n data sent to outside services?
The website says workflows, executions and credentials stay in the user's n8n instance and that the AI reads only what is connected. The README says n8n API keys are stored encrypted and not returned to the AI client.
Is n8n-mcp free?
Yes. n8n-mcp is open source, so you can use and self-host it for free.
What are the best alternatives to n8n-mcp?
The closest alternatives to n8n-mcp are Automation Auditor MCP, Gydmation, Falcon Builder, nana800 and AIOS Builder.
Where this comes from
- Description: written from the project's README and the project's website.