PlugWiki
n8n-mcp logo

n8n-mcp by czlonkowski, a community n8n MCP server

CommunityLocal

Lets Claude, Cursor or Codex look up n8n nodes and templates, then build and edit workflows on your own n8n. You run it yourself.

n8n-mcp is a community project that lets your AI assistant look up n8n nodes and templates, then build, fix and roll back workflows on your own n8n. It adds template search, community nodes, auto-fix, version rollback and credential management. Start with n8n's built-in MCP server, which every n8n plan includes, and add n8n-mcp only for those extras. With your n8n API key it can delete and run workflows, so use a key with only the access you need.

Good for

  • n8n users who want template search, auto-fix, rollback or credential management that n8n's own MCP server lacks
  • Developers who build and debug n8n workflows from Claude Code, Cursor or Codex
  • Anyone who wants an assistant to look up n8n nodes and docs without connecting an n8n instance
  • Not for you if you only need to build, edit and run workflows: try n8n's built-in server first

Works in

6 supported · 1 with issues · 7 should work

Tap an app to see how to set it up and any known problems.

Install n8n MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the n8n MCP server to Claude Code. Run this command:
    
    claude mcp add n8n-mcp -e MCP_MODE=stdio -e LOG_LEVEL=error -e DISABLE_CONSOLE_OUTPUT=true -- npx n8n-mcp
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js (^22.23.4 || ^24.22.1 || >=26.12.1).

The basic setup gives node documentation and validation tools only. Add N8N_API_URL and N8N_API_KEY to also let the assistant create and edit workflows in your n8n. Replace the placeholder URL and key with your own. The README warns never to edit production workflows directly with AI: copy the workflow first, test in a development instance, and keep backups. If two clients start n8n-mcp through npx at the same time, give each its own npm_config_cache folder to avoid cache lock errors. A hosted option exists at dashboard.n8n-mcp.com (free tier of 100 tool calls a day); the README does not list a server address for it, so use the dashboard's own instructions.

From the project README. Source.

Tools

  • Finds n8n nodes by keyword

    Searches all nodes, including community and verified ones, and can include example configs.

    Try: “Find the n8n node for sending Slack messages”

    Read · search_nodes

  • Shows details and docs for one n8n node

    Returns node info at different detail levels, readable docs, property search and version comparison.

    Try: “Show me the settings for the HTTP Request node”

    Read · get_node

  • Finds ready-made n8n workflow templates

    Searches templates by keyword, by the nodes used, by task or by metadata like complexity.

    Try: “Find templates that send Gmail summaries to Slack”

    Read · search_templates

  • Fetches the full workflow of a template

    Returns a template's workflow JSON as nodes only, structure only or in full.

    Try: “Get the full workflow for that template”

    Read · get_template

  • Lists the workflows in your n8n

    Lists workflows with filtering and paging. Needs the n8n API URL and key.

    Try: “List all my n8n workflows”

    Network · n8n_list_workflows

  • Opens one of your workflows

    Returns a workflow in full, as details, as structure only or in minimal form.

    Try: “Show me my invoice-sync workflow”

    Network · n8n_get_workflow

  • Lists, opens or deletes workflow runs

    Manages execution history: list, get and delete.

    Try: “Show my last 5 failed runs”

    Delete · n8n_executions

  • Creates a new workflow in your n8n

    Creates a workflow with nodes and connections.

    Try: “Create a workflow that posts new form entries to Slack”

    Write · n8n_create_workflow

  • Edits part of a workflow

    Updates a workflow using diff operations instead of replacing it.

    Try: “Add a Slack node to the end of my workflow”

    Write · n8n_update_partial_workflow

  • Replaces a whole workflow

    Replaces the entire workflow.

    Try: “Replace my workflow with this new version”

    Write · n8n_update_full_workflow

  • Runs a workflow to test it

    Triggers a workflow over its webhook, form or chat trigger by default. Other methods run workflows with no such trigger through n8n's own MCP server.

    Try: “Run my invoice-sync workflow and show the result”

    Runs code · n8n_test_workflow

  • Permanently deletes a workflow

    Deletes a workflow permanently.

    Try: “Delete my old test workflow”

    Delete · n8n_delete_workflow

Read from the source code

Pros and cons

Good

  • Adds template search over 2,352 n8n workflow templates, which n8n's own server lacks
  • Auto-fix and version rollback help you recover from a bad edit
  • Partial edits change one node without rebuilding the whole workflow
  • Knows 3,143 n8n nodes, including 2,302 community nodes
  • Docs-only mode needs no n8n instance or API key
  • Free and MIT licensed to self-host, with a hosted option
  • Setup guides for Claude Code, Claude Desktop, Cursor, VS Code, Windsurf and Codex

Watch out

  • With an API key it can delete and run workflows and manage credentials
  • Telemetry is on by default
  • Many security advisories in 2026, mostly for HTTP mode
  • Runs on your machine, with Node.js or Docker
  • Generated workflows can still break on import and need fixing
  • Node data tracks n8n 2.44.3, while n8n 3.0 is out
  • Adds a lot of context to every chat

Permissions

high risk · 5 things to watch · 22 advisories

High risk

With an n8n API key it can create, change, delete and run workflows and manage credentials. Use the latest version, a key with only the access you need, and keep HTTP mode off shared networks.

What it can do

Watch out for

  • It has the same power as your n8n API key

    It can create, change, delete and run workflows, including Code nodes, and manage credentials. Use a key with the least access you need, or none for docs-only mode. github.com

  • Telemetry is on by default

    It sends tool usage, sanitized workflow structures and your edit intent text to the maintainer's EU-hosted service. Set N8N_MCP_TELEMETRY_DISABLED=true to turn it off. github.com

  • Update often and keep HTTP mode private

    Most published advisories hit shared HTTP deployments. Update to the latest version, and do not expose HTTP mode to a shared network. github.com

  • Workflow text reaches your assistant

    Workflow names, descriptions and run results go to the model. On a shared n8n, someone who can edit workflows could plant instructions, so review changes before you approve them. github.com

  • It keeps local workflow backups

    Full workflow JSON, including node settings, is saved before each update and kept 30 days by default. github.com

Security advisories

22 known advisories, all fixed in a newer version.

Show all 22
Technical details
Turning on read-onlyLeave out N8N_API_URL and N8N_API_KEY for docs-only mode. Or set DISABLED_TOOLS and DISABLED_TOOL_OPERATIONS as in the README recipe and use a read-only n8n API key.
Talks toYour n8n instance, at the URL you set. The maintainer's EU-hosted telemetry service, unless you turn it off
Sign-in and keysYour n8n API key sits in the server's environment or config file on your machine.
Data retentionFull workflow JSON is saved before each update and kept 30 days by default.
Scopes
  • Everything your n8n API key can do

  • Docs-only mode with no key: documentation, search, validation and template tools

Alternatives

Use n8n's built-in server unless you need template search, auto-fix, rollback or credential management. Pick n8n-mcp for those, or to run it next to the built-in one.

ServerOfficialRunsSign-inCan change thingsToolsStars
For n8n
n8n-mcpThis pageCommunityHostedLocalAPI keyYes2823.2K
Other tools for the same job
n8n built-in MCP serverOfficialHostedAccountYes––
n8n-mcp-server (leonardsellem)CommunityLocalAPI keyYes–1.6K

What people say

People who use it daily rate it highly for editing and debugging workflows, and complain about setup weight and workflows that need fixing.

What people like

  • A months-long user calls it very good and prefers it for debugging and iterating on workflows
  • Partial edits change one part of a workflow instead of rebuilding it, which saves tokens over several fix cycles
  • Users run it next to n8n's own server for template search, auto-fix, rollback and credentials

Common complaints

  • It runs locally, one user needed Docker for full features, and it loads a lot of context
  • Generated workflows can look right but break on import or mismatch node schemas
  • Node search can return only community nodes and miss core ones such as Webhook
  • Telemetry is on by default and includes sanitized workflow structures

In their words

2 more quotes

Questions

n8n-mcp vs n8n's built-in MCP server: which should I use?

Start with n8n's built-in server. It is on every plan, including the free Community edition, and it can search, build, validate and run workflows. It is off by default, so an owner or admin turns it on under Settings. Add n8n-mcp if you want template search, community nodes, auto-fix, version rollback or credential management. Many people run both.

Does n8n's own MCP server rebuild the whole workflow on every edit?

No. A tester said so in May 2026, but n8n staff say its update tool has made partial updates since n8n 2.22.0.

Is n8n-mcp free?

Yes. Self-hosting is free under the MIT license. The hosted service has a free tier of 100 tool calls a day, and the Supporter plan is €19 a month with a fair-use cap of 5,000 calls a day.

Does n8n-mcp send my data anywhere?

Yes, by default. It sends tool usage, sanitized workflow structures and your edit intent text to the maintainer's service, but not credentials or run data, per its privacy policy. Set N8N_MCP_TELEMETRY_DISABLED=true to stop it.

Is it safe? Can it delete my workflows?

Yes, it can delete and run workflows and manage credentials when you give it an n8n API key. It has the same access as that key. Use a limited key, update to the latest version, and do not expose HTTP mode to a shared network.

How do I make n8n-mcp read-only?

Use a read-only n8n API key, and turn off the tools that make changes with the DISABLED_TOOLS and DISABLED_TOOL_OPERATIONS settings from the README recipe. Or leave out the API key and URL to run docs-only mode.

Can I use n8n-mcp without connecting an n8n instance?

Yes. Without the n8n URL and API key it runs only the documentation, search, validation and template tools.

Does n8n-mcp work with n8n 3.0?

Maybe not fully. n8n 3.0 came out on 2026-10-27 with breaking changes, and the n8n-mcp README says its node data tracks n8n 2.44.3. Validate generated workflows before you deploy them.

Why does Claude Desktop show "Unexpected token" errors with n8n-mcp?

Add MCP_MODE set to stdio in the server's env. Without it, log output mixes with the messages Claude Desktop expects.

Why does n8n-mcp refuse to connect to n8n on localhost?

Its protection against requests to internal addresses is strict by default and blocks localhost. Set WEBHOOK_SECURITY_MODE=moderate to allow it.

Examples

  • Build a new workflow starting from an n8n.io template and deploy it to your instance

    Find a template that posts new Typeform responses to Slack, adapt it, validate it and deploy it to my n8n.

    Searches templates, adapts one, checks it and creates it on your instance.

  • Find why a workflow keeps failing by reading its recent executions

    My invoice workflow failed overnight. Look at its latest failed executions and fix the broken node.

    Reads recent runs, finds the failing node and edits it.

  • Change one node in an existing workflow without rebuilding it

    In workflow 'Lead intake', change the Slack channel to #sales and add a retry on the HTTP Request node.

    Makes two targeted edits and leaves the rest of the workflow alone.

  • Run a security audit of your n8n instance

    Audit my n8n instance and list workflows with hardcoded secrets or risky Code nodes.

    Lists workflows that need attention.

Information

updated Nov 2, 2026

Publisher
Community
Package
n8n-mcp
Registry
npm
Transport
stdio, Streamable HTTP
Auth
token in env
License
MIT
Last commit
Oct 27, 2026
Open issues
27

WebsiteDocsGitHubnpmDocker MCP CatalogSelf-Hosting GuideChangelogIssuesTelemetry privacy policyHosted dashboard

Other n8n MCP servers

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 23
  1. n8n-MCP README · github.com
  2. github.com · github.com
  3. github.com · github.com
  4. CURSOR_SETUP.md · github.com
  5. WINDSURF_SETUP.md · github.com
  6. docs.n8n.io · docs.n8n.io
  7. community.n8n.io · community.n8n.io
  8. github.com · github.com
  9. n8n.io · n8n.io
  10. github.com · github.com
  11. github.com · github.com
  12. github.com · github.com
  13. n8n-mcp.com · n8n-mcp.com
  14. docs.n8n.io · docs.n8n.io
  15. github.com · github.com
  16. github.com · github.com
  17. github.com · github.com
  18. github.com · github.com
  19. www.reddit.com · reddit.com
  20. www.reddit.com · reddit.com
  21. github.com · github.com
  22. docs.n8n.io · docs.n8n.io
  23. n8n-mcp-server README · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.