N8n MCP Server

MCP server for building n8n workflows

Local serverstdioGo

What is the N8n MCP server?

MCP server for building n8n workflows. The n8n mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 1 defined tool rather than through you.

What it actually does

A Model Context Protocol (MCP) server for building and manipulating n8n workflows. Build n8n workflows just by prompting with AI — works with Claude Code, VS Code, Cursor, and any MCP-compatible client.

  • Workflow Management — Create, update, and execute n8n workflows programmatically (execute is not implemented yet)
  • Node Discovery — Explore available n8n nodes and their capabilities
  • Connection Management — Create connections between workflow nodes
  • AI Integration — Special tools for connecting AI components in workflows
  • AI-Friendly Interface — Designed specifically for interaction with AI agents
  • N8N Version Management — Automatic version detection and compatibility handling - supports 184+ n8n versions (1.86.0 – 2.6.2) with dynamic node filtering and "closest lower version" matching for backward compatibility

Its toolset

Everything the assistant can do here goes through one of these:

  • General — 1. Check your MCP config — make sure JSON is valid and the server name matches. 2. Update Node.js to the latest LTS version. 3. **Clear npm

Adding it to your client

The server ships on npm as command, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Configuration

You will need 2 environment variables: N8N_API_URL, N8N_API_KEY. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • Node.js (v18 or higher) - npm (for npx command) - An MCP-compatible client (Claude Code, VS Code, Cursor, etc.)

When to reach for it

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. N8n's toolset — General — is a fair guide to whether it matches your workflow. It is maintained by ifmelate; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against N8n's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the n8n mcp server does with a few real requests.

Available tools

ToolWhat it does
General1. **Check your MCP config** — make sure JSON is valid and the server name matches. 2. **Update Node.js** to the latest LTS version. 3. **Clear npm cache** if npx fails: npm cache clean --force 4. **Try global install**

How to install the N8n MCP server

{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": ["-y", "n8n-workflow-builder-mcp"],
      "env": {
        "N8N_API_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-n8n-api-key-here"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js (v18 or higher) - npm (for npx command) - An MCP-compatible client (Claude Code, VS Code, Cursor, etc.)
VariableDescriptionRequired
N8N_API_URLEndpoint or connection string the server talks to.Yes
N8N_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use N8n to General.

Frequently asked questions

It connects N8n to MCP-compatible AI assistants such as Claude and Cursor, exposing 1 tool (General) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with N8n directly.