How do I install N8n MCP Server?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does N8n MCP Server need an API key?

The publisher lists these environment variables: N8N_BASE_URL, N8N_API_KEY.

What transport does N8n MCP Server use?

N8n MCP Server runs locally over stdio.

When was N8n MCP Server last checked?

Last checked 2026-11-09. The most complete MCP server for n8n — 43 tools for workflows, data tables, and more.

N8n MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @nextoolsolutions/[email protected]

Credentials from the publisher

N8N_BASE_URL — n8n instance URL (e.g. http://localhost:5678)
N8N_API_KEY — n8n API key

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1N8N_BASE_URL=<value> N8N_API_KEY=<secret> claude mcp add io.github.rpgmais-mcp-n8n -- npx -y @nextoolsolutions/mcp-n8n@2.0.2

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.rpgmais-mcp-n8n": {4      "command": "npx",5      "args": [6        "-y",7        "@nextoolsolutions/[email protected]"8      ],9      "env": {10        "N8N_BASE_URL": "<value>",11        "N8N_API_KEY": "<secret>"12      }13    }14  }15}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 2.0.2
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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

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

🚀 Quick Start

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

Add to ~/.cursor/mcp.json:

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

Add to claude_desktop_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

Add to your Windsurf MCP config:

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

Add to your VS Code settings.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

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

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 ⭐

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install N8n MCP Server?

Does N8n MCP Server need an API key?

What transport does N8n MCP Server use?

When was N8n MCP Server last checked?

Documentation

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