N8n-mcp Server

An MCP server for n8n that gives Claude, Cursor, and other AI agents tools for generating workflows, linting, diagnosing failed executions, and driving live n8n instances.

Local serverstdioMIT

What is the N8n-mcp Server?

n8n-mcp is an MCP project maintained in the ratamaha-git/n8n-mcp repository. The maintainer describes its purpose as “An MCP server for n8n that gives Claude, Cursor, and other AI agents tools for generating workflows, linting, diagnosing failed executions, and driving live n8n…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @automatelab/n8n-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares N8N_API_URL, N8N_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

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
workflow_generate
node_scaffoldDescription → single INodeType TypeScript file for a custom n8n package.
workflow_lint
workflow_diffTwo workflows → semantic diff (nodes added/removed/modified, connections, settings).
execution_explain
execution_replayWorkflow + node → self-contained replay workflow that exercises just that node.
execution_timelineExecution JSON → per-node timeline table (start, duration, items in/out, errors).
workflow_listPaginate workflows; filter by active/tags/name.
workflow_getFetch a workflow by id.
workflow_createPOST a workflow. Strips read-only fields.
workflow_activateFlip active on/off.
execution_listBrowse executions; pass includeData: true for the full body.

How to install the N8n-mcp Server

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": [
        "-y",
        "@automatelab/n8n-mcp"
      ],
      "env": {
        "N8N_API_URL": "https://your-n8n.example.com",
        "N8N_API_KEY": "YOUR_N8N_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
N8N_API_URLDeclared in the maintainer’s client configuration.Check documentation
N8N_API_KEYDeclared in the maintainer’s client configuration.Check documentation