PlugWiki
@leonardsellem/n8n-mcp-server logo

n8n MCP Server (Leonardsellem): Setup for Claude, Cursor and Other Apps

CommunityLocal
Getnpm@leonardsellem/n8n-mcp-serverleonardsellem/n8n-mcp-server

Lets Claude, Cursor and other assistants list, build, switch on and delete workflows in your n8n, and read their past runs.

This community server connects an assistant to your own n8n through the n8n API. It runs on your computer, and you give it your n8n address and an n8n API key. The assistant can then read, change and delete workflows and run records with that key.

It is built for people who run n8n and want to describe a workflow in plain words instead of wiring nodes by hand. Check each change in n8n before you switch a workflow on, because the key has the same reach as your n8n account.

Good for

  • n8n users who want to build or edit workflows by describing them
  • Teams who check failed runs by asking instead of opening n8n
  • Developers who already run n8n and want Claude Code or Cursor to manage it

Works in

12 should work

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

Install @leonardsellem/n8n-mcp-server

Claude Code

  1. 1

    Copy this prompt.

    Add the @leonardsellem/n8n-mcp-server server to Claude Code. Run this command:
    
    claude mcp add n8n -e N8N_API_URL=<N8N_API_URL> -e N8N_API_KEY=<N8N_API_KEY> -- npx -y @leonardsellem/n8n-mcp-server
    
    Ask me for N8N_API_URL, N8N_API_KEY and only put the values in that config, nowhere else.
    
    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.

Built from the package data we hold. Not yet tested by us.

Tools

  • Lists the workflows in your n8n, optionally only active or inactive

    Returns every workflow in your n8n with its name and whether it is switched on. You can filter to active or inactive ones.

    Try: “Which of my n8n workflows are currently active?”

    Network · list_workflows

  • Shows one workflow's full details by ID

    Fetches a single workflow by its ID, including its nodes and connections, so the assistant can explain or edit it.

    Try: “Show me how the 'Weekly report' workflow is built.”

    Network · get_workflow

  • Builds a new workflow from nodes and connections

    Creates a workflow in n8n from a name, a list of nodes and the links between them. It can switch the workflow on at creation and add tags.

    Try: “Create a workflow that posts a Slack message every Monday at 9am.”

    Write · create_workflow

  • Changes an existing workflow's name, nodes or connections

    Reads the current workflow, then saves your changes to its name, nodes, connections or tags. The active flag is not changed here; the activate and deactivate tools do that.

    Try: “Rename the 'Weekly report' workflow and add a step that emails the result.”

    Write · update_workflow

  • Deletes a workflow from n8n

    Removes the workflow with the given ID from your n8n. Your assistant can call it without a second prompt unless your app asks you to confirm each tool call.

    Try: “Delete the old 'Test import' workflow.”

    Delete · delete_workflow

  • Switches a workflow on

    Turns a workflow on so its triggers start running, and returns its name and new state.

    Try: “Activate the 'Invoice reminder' workflow.”

    Write · activate_workflow

  • Switches a workflow off

    Turns a workflow off so its triggers stop firing, and returns its name and new state.

    Try: “Pause the 'Invoice reminder' workflow.”

    Write · deactivate_workflow

  • Lists past workflow runs, filterable by workflow and status

    Returns recent runs from n8n. You can filter by workflow, by result (success, error, waiting, canceled), set a limit, page through results and ask for summary counts.

    Try: “Which executions of 'Weekly report' failed this week?”

    Network · list_executions

  • Shows what happened in one run

    Fetches the details of a single execution by ID, so the assistant can find where it failed.

    Try: “Why did execution 4812 fail?”

    Network · get_execution

  • Deletes a run from n8n's history

    Removes one stored execution record from n8n by ID. The record and its logged data are gone afterwards.

    Try: “Delete execution 4812.”

    Delete · delete_execution

  • Triggers a workflow through its webhook URL

    Calls a workflow's webhook at your n8n address under /webhook/ using the name you give, with optional data and headers. It needs the webhook username and password to be set, and the workflow then actually runs.

    Try: “Trigger the 'hello-world' webhook with the message 'test'.”

    Write · run_webhook

Read from the source code

Permissions

high risk · 4 things to watch

High risk

The assistant can edit, switch on and delete workflows and run records in your n8n, using an API key that reaches everything that key reaches. Use a dedicated key, try it on a non-critical n8n first, and keep per-tool approval turned on.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It can delete workflows and run history

    delete_workflow and delete_execution remove items from n8n for good. Back up important workflows, and keep your app's per-tool approval on. github.com

  • It can rewrite and switch on live workflows

    update_workflow, activate_workflow and create_workflow change what runs on your n8n, which can send emails or call other services. Review a change before activating it. github.com

  • The API key reaches your whole n8n

    The key you paste in is not limited by this server to certain workflows. Use a dedicated key on a test or non-critical n8n if you can. github.com

  • The README tool names are out of date

    The README lists names like workflow_list and execution_stop, but the published code registers list_workflows and no stop tool. Prompts in plain words work either way. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyNo read-only switch is documented or present in the tool registrations. Your n8n API key's own permissions are the only limit.
Talks toYour n8n instance (the address you set)
Sign-in and keysThe n8n API key and address are read from environment variables set in your app's config.
Scopes
  • n8n API key

Questions

Is it official?

No. It is a community project by Leonard Sellem, not made by n8n. n8n ships its own built-in MCP server, covered in the comparison answer below.

Which clients does it work in?

It runs on your computer over stdio, so it fits Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Codex and other apps that start local servers. The README shows a Claude Desktop-style config and VS Code settings.

What credentials does it need?

An n8n API key and your n8n address ending in /api/v1. Create the key in n8n under Settings, then API. The webhook username and password are only needed for the webhook tool.

Can I run it read-only?

No. There is no read-only switch, so every tool is on, including the delete tools. The only limit is what your n8n API key is allowed to do.

Does it work with n8n Cloud?

The README only says you need an n8n instance with API access enabled and the address ending in /api/v1. It does not name n8n Cloud, so check that your plan allows API keys.

Why do the tool names in the README not match?

The README lists older names such as workflow_list and execution_stop. The published package registers 11 tools with names like list_workflows and delete_execution, and that is the list on this page.

How does it compare with n8n's built-in MCP server and n8n-mcp?

It is the smaller, older option: 11 tools for workflows and runs, last published as 0.1.8 in June 2025. n8n's own built-in MCP server needs no extra package. You switch it on under Settings, Instance-level MCP, expose chosen workflows, and it can search, run, create and edit workflows (building and editing needs n8n 2.13.0 or later). It limits access to workflows you enable, while this server's API key reaches everything. The czlonkowski n8n-mcp server (28 tools, see /mcp/czlonkowski-n8n-mcp) adds node and template lookup that this one lacks. Pick this one only if you want a plain API wrapper that includes delete tools.

Information

updated Nov 2, 2026

Publisher
Community
Package
@leonardsellem/n8n-mcp-server
Registry
npm
Transport
stdio
Auth
API key
Version
0.1.8
License
MIT
Last commit
Jul 9, 2025

GitHubnpmIssues

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 4
  1. n8n MCP Server README · github.com
  2. Tool definitions in the source · github.com
  3. npm package metadata · registry.npmjs.org
  4. Connect to n8n MCP server · docs.n8n.io

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