
n8n MCP Server (Leonardsellem): Setup for Claude, Cursor and Other Apps
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.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install @leonardsellem/n8n-mcp-server
Claude Code
- 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
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_workflowsShows 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_workflowBuilds 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_workflowChanges 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_workflowDeletes 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_workflowSwitches 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_workflowSwitches 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_workflowLists 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_executionsShows 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_executionDeletes 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_executionTriggers 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-only | No read-only switch is documented or present in the tool registrations. Your n8n API key's own permissions are the only limit. |
|---|---|
| Talks to | Your n8n instance (the address you set) |
| Sign-in and keys | The n8n API key and address are read from environment variables set in your app's config. |
| Scopes |
|
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
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 4Hide
- n8n MCP Server README · github.com
- Tool definitions in the source · github.com
- npm package metadata · registry.npmjs.org
- Connect to n8n MCP server · docs.n8n.io