N8n MCP Server

The most complete MCP server for n8n — 43 tools for workflows, data tables, and more.

Developer Tools
1stars
No ratings
UpdatedOct 8, 2026

InstallRepository Website

Install N8n MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js

~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "n8n-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@nextoolsolutions/mcp-n8n"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 43 tools correctly (18d ago).

Overview

Workflow automation

Tools43

What N8n MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~4.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

13/18 checks healthy over the last 95d

What it can do

From the 43 tools this server returned when we ran it.

Runs commands · 1Can delete or modify data · 8Handles credentials · 5Makes network requests · 1Read-only tools · 34

Network at startup3 connections

Files written at startupNone

Install scriptsNone

npm provenanceNot published

Package age232 days

Maintainers1

Observed 2026-10-26 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 2d ago via OSV.dev · @nextoolsolutions/mcp-n8n (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.

npm downloads146Package downloads in the last 30 days.

Last commit1mo agoMost recent push to the default branch.

Availability100%Our rolling endpoint + install checks that succeeded.

Install checkPassedOur sandbox started it and listed its tools.

Tools exposed43Callable tools this server registers over MCP.

Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

From the project README

mcp-n8n

The most complete MCP server for n8n

43 tools · Workflows · Data Tables · Tags · Credentials · Users · Webhooks · Audit

Quick Start · All 43 Tools · Configuration · Contributing

Why mcp-n8n?

Other n8n MCPs cover workflows and executions. mcp-n8n covers everything — including Data Tables, the only MCP to do so.

Feature	mcp-n8n	leonardsellem	illuminare	czlonkowski
Workflows (CRUD + execute)	10	7	8	4
Executions	3	5	3	2
Data Tables	8	—	—	—
Tags + Workflow Tags	7	—	5	—
Credentials	4	—	3	—
Users	3	—	4	—
Variables	3	—	3	—
Projects (Enterprise)	4	—	4	—
Security Audit	1	—	1	—
Webhooks	1	1	—	1
Health Check	1	—	—	1
Total	43	12	33	20

Data Tables — full CRUD with filters, search, upsert and dry-run. No other MCP has this.

🚀 Quick Start

Claude Code

Terminal

claude mcp add --scope user \
  -e N8N_BASE_URL=http://localhost:5678 \
  -e N8N_API_KEY=your-api-key \
  -- n8n npx -y @nextoolsolutions/mcp-n8n

Cursor

Add to ~/.cursor/mcp.json:

config.json

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

Claude Desktop

Add to claude_desktop_config.json:

config.json

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

Config file location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Windsurf

Add to your Windsurf MCP config:

config.json

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

VS Code (Copilot)

Add to your VS Code settings.json:

config.json

{
  "mcp": {
    "servers": {
      "n8n": {
        "command": "npx",
        "args": ["-y", "mcp-n8n"],
        "env": {
          "N8N_BASE_URL": "http://localhost:5678",
          "N8N_API_KEY": "your-api-key"
        }
      }
    }
  }
}

Getting your API key

Open your n8n instance
Go to Settings → n8n API
Create a new API key
Copy it into the N8N_API_KEY environment variable

🛠 Tools

Workflows (10)

Tool	Description
`n8n_list_workflows`	List all workflows with optional filters
`n8n_get_workflow`	Get a workflow by ID (includes nodes, connections, settings)
`n8n_create_workflow`	Create a new workflow from JSON
`n8n_update_workflow`	Update an existing workflow (full replacement)
`n8n_delete_workflow`	Permanently delete a workflow
`n8n_activate_workflow`	Activate a workflow for production
`n8n_deactivate_workflow`	Deactivate a workflow
`n8n_execute_workflow`	Trigger execution with optional input data
`n8n_get_workflow_tags`	List tags associated with a workflow
`n8n_update_workflow_tags`	Replace all tags on a workflow

Executions (3)

Tool	Description
`n8n_list_executions`	List executions with filters (workflow, status, cursor)
`n8n_get_execution`	Get execution status, result data and timing
`n8n_delete_execution`	Delete an execution record

Data Tables (8)

Only available in n8n v1.64+. This is the only MCP server with Data Tables support.

Tool	Description
`n8n_list_datatables`	List all data tables with filtering and sorting
`n8n_create_datatable`	Create a table with typed columns (string, number, boolean, date, json)
`n8n_get_datatable`	Get table metadata (columns, name, ID)
`n8n_get_datatable_rows`	Query rows with filter, full-text search, sorting and pagination
`n8n_insert_datatable_rows`	Insert one or more rows
`n8n_update_datatable_rows`	Update rows matching a filter (supports dry-run)
`n8n_upsert_datatable_row`	Update if exists, insert if not
`n8n_delete_datatable_rows`	Delete rows matching a filter (supports dry-run)

Tags (5)

Tool	Description
`n8n_list_tags`	List all tags
`n8n_get_tag`	Get a tag by ID
`n8n_create_tag`	Create a new tag
`n8n_update_tag`	Rename a tag
`n8n_delete_tag`	Delete a tag

Credentials (4)

Tool	Description
`n8n_list_credentials`	List credentials (names and types only — data is redacted)
`n8n_create_credential`	Create a credential (use `get_credential_schema` first)
`n8n_delete_credential`	Delete a credential
`n8n_get_credential_schema`	Get the JSON schema for a credential type

Users (3)

Tool	Description
`n8n_list_users`	List all users (requires instance owner role)
`n8n_get_user`	Get a user by ID or email
`n8n_delete_user`	Delete a user

Variables (3)

Tool	Description
`n8n_list_variables`	List all environment variables
`n8n_create_variable`	Create a key-value variable
`n8n_delete_variable`	Delete a variable

Projects (4) — Enterprise

Tool	Description
`n8n_list_projects`	List all projects
`n8n_create_project`	Create a project
`n8n_update_project`	Rename a project
`n8n_delete_project`	Delete a project

Audit (1)

Tool	Description
`n8n_generate_audit`	Generate a security audit (credentials, database, filesystem, nodes)

System (1)

Tool	Description
`n8n_health_check`	Verify n8n API connectivity

Webhooks (1)

Tool	Description
`n8n_trigger_webhook`	Trigger a workflow via its webhook URL (production or test)

⚙️ Configuration

Variable	Default	Description
`N8N_BASE_URL`	`http://localhost:5678`	Your n8n instance URL
`N8N_API_KEY`	—	API key (required)
`N8N_MAX_RETRIES`	`3`	Retry attempts on 429 / 5xx errors
`N8N_TIMEOUT`	`30000`	Request timeout in milliseconds

✨ Features

43 tools — the most comprehensive n8n MCP available
Data Tables — full CRUD, the only MCP with this support
Automatic retry — exponential backoff on rate limits (429) and server errors (5xx)
Configurable timeout — prevent hung requests (default 30s)
Zero external dependencies — only MCP SDK + Zod
TypeScript strict mode — fully typed, safe, and maintainable
Node 16+ compatible — native fetch with http/https fallback

🔒 Security

API keys are never hardcoded — loaded exclusively from environment variables
Credential data is redacted in list responses (n8n API behavior)
All IDs are sanitized with encodeURIComponent to prevent path traversal
No sensitive data is logged or exposed in error messages

🏗 Development

bash

git clone https://github.com/NexTools-Solutions/mcp-n8n.git
cd mcp-n8n
npm install

Command	Description
`npm run dev`	Run with tsx (no build step)
`npm run build`	Compile TypeScript to `dist/`
`npm start`	Run compiled version

Project structure

Code

mcp-n8n/
├── src/
│   ├── index.ts          # MCP server — tool registration and handlers
│   └── n8n-client.ts     # HTTP client — API calls, retry, timeout
├── dist/                  # Compiled output
├── package.json
├── tsconfig.json
└── README.md

🤝 Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch (git checkout -b feat/my-feature)
Commit your changes
Push and open a Pull Request

📄 License

MIT — free for personal and commercial use.

Built by NexTool Solutions

If this project helps you, consider giving it a ⭐

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about N8n MCP Server

n8n MCP Server is an MCP server that connects MCP-enabled clients to an n8n instance through its API, exposing 43 tools for workflows, executions, data tables, tags, credentials, users, variables, projects, security audits, webhooks, and health checks. It supports workflow CRUD and execution plus data-table CRUD, filters, search, upsert, and dry-run operations.

Configure the server by setting N8N_BASE_URL to your n8n instance URL and N8N_API_KEY to an n8n API key, then launch it with npx in your MCP client configuration. The README includes setup examples for Claude Code, Cursor, Claude Desktop, Windsurf, and VS Code Copilot.

This MCP server supports 43 tools covering workflows, executions, data tables, tags, workflow tags, credentials, users, variables, projects, security audits, webhooks, and health checks. Its data-table tools provide CRUD operations with filters, search, upsert, and dry-run support.

Get an API key from your n8n instance by opening Settings, selecting n8n API, creating a new API key, and assigning the value to the N8N_API_KEY environment variable used by the MCP server.

Related MCP servers

All in Developer Tools All alternatives

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/n8n-mcp-server?style=directory)](https://allmcps.com/mcp/n8n-mcp-server)

HTML Embed

<a href="https://allmcps.com/mcp/n8n-mcp-server"><img src="https://allmcps.com/api/badge/n8n-mcp-server?style=directory" alt="N8n MCP Server on AllMCPs" /></a>

At a glance

Category: Developer Tools
Transport: STDIO
Runtime: Node.js
Last updated: Oct 8, 2026

GitHub stars1

Last commit1mo ago

npm / month146

69Quality signal: Great · 69/100How this signal is calculated ▾

Server availability25/25

Trust & verification10/20

Documentation & tools29/30

Adoption & activity5/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Own this project?

This listing is pre-filled from public sources. Claim it via your GitHub README, a site badge, or DNS TXT to edit it and earn the Verified owner badge.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically.

Claim this listing

Install N8n MCP Server

What it can do

Supply-chain signal

Adoption & maintenance

From the project README

mcp-n8n

Why mcp-n8n?

🚀 Quick Start

Getting your API key

🛠 Tools

Workflows (10)

Executions (3)

Data Tables (8)

Tags (5)

Credentials (4)

Users (3)

Variables (3)

Projects (4) — Enterprise

Audit (1)

System (1)

Webhooks (1)

⚙️ Configuration

✨ Features

🔒 Security

🏗 Development

Project structure

🤝 Contributing

📄 License

Frequently Asked Questions about N8n MCP Server

What is the n8n MCP Server MCP server?

How do I configure the n8n MCP Server?

What n8n features does this MCP server support?

How do I get an API key for the n8n MCP server?

AllMCPs Directory Badge