1. Home
  2. n8n MCP Server
  3. n8n MCP Server for Claude Code: Setup & Config

Data as of

n8n MCP Server for Claude Code: Setup & Config

n8n MCP Server lets Claude Code manage workflows and inspect or control executions in an n8n instance.

n8n MCP Server Claude Code configuration

  1. Choose Claude Code configuration scope

    For n8n MCP Server, open Project scope: .mcp.json at the repository root. Project JSON: merge into mcpServers; user scope: use the CLI.

  2. Add n8n MCP Server to Claude Code

    Use the n8n-mcp-server entry below in mcpServers. Keep n8n MCP Server's documented stdio connection fields and your other Claude Code entries.

  3. Check n8n MCP Server in Claude Code

    n8n MCP Server: Inspect claude mcp list and /mcp status.

Config file · Project scope: .mcp.json at the repository root

JSON
{
  "mcpServers": {
    "n8n-mcp-server": {
      "type": "stdio",
      "command": "n8n-mcp-server",
      "args": [],
      "env": {
        "N8N_API_URL": "<Full n8n API URL including /api/v1>",
        "N8N_API_KEY": "<n8n API key with appropriate permissions>"
      }
    }
  }
}

CLI (POSIX shell)
claude mcp add-json --scope project 'n8n-mcp-server' '{"type":"stdio","command":"n8n-mcp-server","args":[],"env":{"N8N_API_URL":"<Full n8n API URL including /api/v1>","N8N_API_KEY":"<n8n API key with appropriate permissions>"}}'

n8n in Claude Code: stdio checks

  • If n8n MCP Server fails to start, check n8n-mcp-server, the working directory, and Claude Code's selected scope; inspect claude mcp list and /mcp.
  • n8n MCP Server: check N8N_API_KEY, N8N_API_URL; keep credentials out of shared .mcp.json.
  • n8n MCP Server uses stdio here: Claude Code must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
Tools
workflow_list, workflow_get, workflow_create

n8n MCP Server — details. Claude Code guide

Frequently asked questions

Register n8n MCP Server with the displayed claude mcp add-json --scope project command, or merge the JSON into .mcp.json at the repository root.

Claude Code's n8n-mcp-server example uses stdio.

n8n MCP Server's Claude Code configuration invokes n8n-mcp-server.

Claude Code's n8n MCP Server example references N8N_API_KEY, N8N_API_URL. Check these names if startup or authentication fails; the example alone does not distinguish required from optional values.

n8n MCP Server's stored list contains 12 tools, including workflow_list, workflow_get, workflow_create. Compare those names with Claude Code's connected tool list; the stored list is not a live check.