n8n MCP Server

Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.

Local + remotestdiostreamable-httpTypeScriptMIT★ 22.5k

What is the n8n MCP Server?

n8n-MCP gives AI assistants indexed documentation for thousands of n8n nodes plus validation and, optionally, live workflow management against your own instance.

Configuration

Node.js for the npx path, or Docker for container deployments. The documentation tools work with no credentials; workflow management additionally needs N8N_API_URL and an n8n API key.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

What you can do with it

Building a workflow from a natural-language brief

The assistant searches templates first, falls back to node discovery, validates each node configuration, then emits a workflow JSON that actually imports cleanly.

Debugging a workflow that fails at runtime

Validate connections and expressions against the real node schemas to find the unset parameter or bad reference, rather than reading stack traces from n8n's execution log.

Read-only instance inspection

Run with a read-only API key and DISABLED_TOOLS set so an agent can list workflows, read executions and audit configuration without any ability to modify them.

Learning the node catalogue

Ask which nodes can act as AI tools, what a node's authentication properties are, or how a given operation is configured, without tab-hopping through docs.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
tools_documentationReturns usage documentation and best practices for the server's own tools — the recommended first call.
search_nodesFull-text search across the node catalogue, with source filters for community or verified nodes and an option to include real example configurations.
get_nodeUnified node lookup with minimal, standard and full detail levels plus modes for property search, markdown docs, version comparison and breaking changes.
validate_nodeValidate a node configuration, either as a fast required-fields check or a full pass using a chosen validation profile.
validate_workflowValidate an entire workflow including connections, expressions and AI agent wiring.
search_templatesFind workflow templates by keyword, by node types used, by curated task, or by metadata such as complexity and target audience.
get_templateRetrieve a template's workflow JSON at nodes-only, structure or full fidelity.
n8n_create_workflowCreate a new workflow with nodes and connections on the connected instance.
n8n_get_workflowRetrieve a workflow at full, details, structure or minimal fidelity.
n8n_update_partial_workflowApply batched diff operations to a workflow without resending the whole JSON.
n8n_update_full_workflowReplace an entire workflow definition.
n8n_delete_workflowPermanently delete a workflow.
n8n_list_workflowsList workflows with filtering and pagination.
n8n_validate_workflowValidate a workflow that already lives on the instance, by id.
n8n_autofix_workflowAutomatically repair common structural errors in a deployed workflow.
n8n_workflow_versionsInspect version history and roll a workflow back.
n8n_deploy_templateDeploy a template from n8n.io straight to your instance with autofix applied.
n8n_test_workflowTrigger a workflow execution via webhook, form or chat entry point.
n8n_executionsList, fetch and delete workflow executions.
n8n_evaluationsRun and read evaluation test runs, including aggregated metrics and per-case results.
n8n_manage_datatableList, get, create, update and delete n8n data tables and their rows.
n8n_manage_credentialsManage credentials, including schema lookup. Frequently disabled outright because even reads expose sensitive material.
n8n_audit_instanceSecurity audit combining n8n's built-in audit API with a deeper workflow scan.
n8n_health_checkCheck n8n API connectivity and report available features.

How to install the n8n MCP Server

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key"
      }
    }
  }
}

Configuration

Node.js for the npx path, or Docker for container deployments. The documentation tools work with no credentials; workflow management additionally needs N8N_API_URL and an n8n API key.

VariableDescriptionRequired
MCP_MODESet to stdio for desktop clients so only JSON-RPC reaches stdout; without it clients report JSON parse errors.e.g. stdioYes
N8N_API_URLBase URL of your n8n instance. Required to unlock the workflow management tools.e.g. https://your-n8n-instance.comOptional
N8N_API_KEYn8n API key created under Settings then API. Use a read-only key when you only want inspection.Optional
N8N_CF_CLIENT_IDCloudflare Access service-token client ID, if your n8n instance sits behind Zero Trust.Optional
N8N_CF_CLIENT_SECRETCloudflare Access service-token secret, sent only to the N8N_API_URL origin.Optional
DISABLED_TOOLSComma-separated tool names to remove entirely — the recommended way to build a read-only deployment.e.g. n8n_delete_workflow,n8n_manage_credentialsOptional
DISABLED_TOOL_OPERATIONSBlocks individual operations inside tools that mix reads and writes, e.g. n8n_executions:delete.e.g. n8n_executions:deleteOptional
LOG_LEVELLogging verbosity; error keeps stdio clean.e.g. errorOptional

Example prompts to try

  • “Find an existing template that posts form submissions to Slack, then adapt it to send to #alerts instead.”
  • “What are all the required parameters on the HTTP Request node when using header auth?”
  • “Validate this workflow JSON and fix every error before I import it.”
  • “List my workflows that have failed in the last 24 hours and summarise why.”

Frequently asked questions

Not for the documentation half. Search, node lookup, template discovery and validation all run against a database bundled with the package, so you can use it purely as a reference layer while drafting workflows. The management tools — creating, updating, deleting, executing and auditing workflows — only register once you set N8N_API_URL and N8N_API_KEY.