n8n-MCP

Lets an assistant look up n8n nodes and templates and build, validate and manage n8n workflows.

By Romuald Członkowski (individual) TypeScript Local · stdio ProductivityDeveloper tools

100 popularity score ★ 23k ↓ 47k/wk

Connect your client

Local (npm)

Add in one click

Opens the app, which asks before it adds the server. Then replace each <NAME> in its settings with your value.

Or add it by command or config

It needs MCP_MODE. Replace each <NAME> with your value.

Claude CodeTerminal
claude mcp add n8n -e MCP_MODE=<MCP_MODE> -- npx -y n8n-mcp
Claude Desktopclaude_desktop_config.json
{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ],
      "env": {
        "MCP_MODE": "<MCP_MODE>"
      }
    }
  }
}
Cursor~/.cursor/mcp.json
{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ],
      "env": {
        "MCP_MODE": "<MCP_MODE>"
      }
    }
  }
}
VS Code.vscode/mcp.json
{
  "servers": {
    "n8n": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ],
      "env": {
        "MCP_MODE": "<MCP_MODE>"
      }
    }
  }
}
Codex~/.codex/config.toml
[mcp_servers.n8n]
command = "npx"
args = ["-y", "n8n-mcp"]

[mcp_servers.n8n.env]
MCP_MODE = "<MCP_MODE>"
Gemini CLITerminal
gemini mcp add --scope user -e MCP_MODE=<MCP_MODE> n8n npx -- -y n8n-mcp

Settings 11

MCP_MODE Required: Set to stdio when run from a desktop client; the docs say it is required for Claude Desktop.
LOG_LEVEL Optional: Log level; the docs' example uses error.
DISABLE_CONSOLE_OUTPUT Optional: Set to true to keep console output off stdout.
N8N_API_URL Optional: URL of your n8n instance; needed for the n8n management tools.
N8N_API_KEY Optional: n8n API key; needed for the n8n management tools.
N8N_MCP_ACCESS_TOKEN Optional: Instance-level MCP key from n8n settings, for agents, node resource discovery and some run modes.
N8N_CF_CLIENT_ID Optional: Cloudflare Access client ID, when the n8n instance is behind Cloudflare Access.
N8N_CF_CLIENT_SECRET Optional: Cloudflare Access client secret, when the n8n instance is behind Cloudflare Access.
DISABLED_TOOLS Optional: Comma-separated tools to turn off, for example for a read-only deployment.
DISABLED_TOOL_OPERATIONS Optional: Write operations to block inside tools that mix read and write.
N8N_MCP_TELEMETRY_DISABLED Optional: Set to true to turn off telemetry (Docker); with npx run n8n-mcp telemetry disable.

What it does

n8n-MCP gives an assistant structured knowledge of n8n, the workflow automation platform: documentation, properties and operations for about 2,950 nodes (core and community), real-world example configurations, and a library of workflow templates. With it an assistant can find the right nodes, read their settings, and validate a node or a whole workflow before it is built.

When it is given the URL and API key of an n8n instance, a second set of tools manages that instance: create, update, validate, auto-fix, version and delete workflows, deploy templates, run workflows and read executions, and manage folders, data tables, credentials, evaluations and agents, plus a security audit. Some features also need the instance-level MCP access token from n8n's settings.

It runs locally with npx n8n-mcp (Node.js, with a pre-built node database included) or from the Docker image ghcr.io/czlonkowski/n8n-mcp; the docs say MCP_MODE=stdio is required for Claude Desktop. It can also be deployed over HTTP, and the maker runs a hosted version at dashboard.n8n-mcp.com with a free tier of 100 tool calls a day. The README warns never to edit production workflows directly with an assistant: copy them, test in development and keep backups.

Tools 28

tools_documentation
Get documentation for any of the server's tools.
search_nodes
Full-text search across n8n nodes, including community and verified community nodes, optionally with example configurations.
get_node
Node information in several modes: properties at chosen detail, human-readable docs, property search, and version comparison and migrations.
validate_node
Validate a node configuration, from a quick required-fields check to full validation with profiles.
validate_workflow
Validate a complete workflow, including AI Agent workflows.
search_templates
Search n8n workflow templates by keyword, by nodes used, by task, or by metadata such as complexity.
get_template
Get a template's workflow JSON (nodes only, structure or full).
n8n_create_workflow
Create a new workflow with nodes and connections in your n8n instance.
n8n_get_workflow
Retrieve a workflow (full, details, structure or minimal).
n8n_update_full_workflow
Replace an entire workflow.
n8n_update_partial_workflow
Update a workflow with diff operations.
n8n_delete_workflow
Delete a workflow permanently.
n8n_list_workflows
List workflows with filtering and pagination.
n8n_validate_workflow
Validate a workflow in n8n by ID.
n8n_autofix_workflow
Automatically fix common workflow errors.
n8n_workflow_versions
Version history, diff and rollback, from n8n-mcp's own snapshots or n8n's workflow history.
n8n_deploy_template
Deploy a template from n8n.io to your instance, with auto-fix.
n8n_explore_node_resources
Resolve a node's dynamic dropdown or resource-locator values (Slack channels, Sheets tabs, model lists) using a real credential; needs N8N_MCP_ACCESS_TOKEN.
n8n_test_workflow
Run a workflow through its webhook, form or chat trigger, or through n8n's own MCP server.
n8n_executions
List, get and delete executions.
n8n_evaluations
Run and read evaluation test runs.
n8n_manage_folders
Create, list, get, rename, move and delete workflow folders.
n8n_manage_datatable
Manage n8n data tables, rows and columns.
n8n_manage_credentials
List, get, create, update and delete n8n credentials, and get credential schemas.
n8n_audit_instance
Security audit combining n8n's audit API with workflow scanning.
n8n_manage_agents
Manage n8n Agents through n8n's instance-level MCP server; needs N8N_MCP_ACCESS_TOKEN.
n8n_health_check
Check n8n API connectivity and features.
n8n_list_catalog
List instance-level projects or tags.

Similar servers