Skip to main content

​
Quick Start

Get n8n-MCP running in minutes without any installation: 
npx n8n-mcp
The package includes a pre-built database with all n8n node information.
npx will download and run the latest version automatically on first use.

​
Prerequisites

  • Node.js installed on your system
  • Claude Desktop application

​
Configuration

​
Basic Setup (Documentation Tools Only)

Add to your Claude Desktop configuration file: 
{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true"
      }
    }
  }
}
The MCP_MODE: "stdio" environment variable is required for Claude Desktop. Without it, you will see JSON parsing errors like "Unexpected token..." in the UI.

​
Full Setup (With n8n Management Tools)

To enable workflow management capabilities: 
{
  "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 File Locations

~/Library/Application Support/Claude/claude_desktop_config.json

​
Restart Claude Desktop

After updating the configuration file, restart Claude Desktop for changes to take effect.

​
Environment Variables

VariableDescriptionRequired
MCP_MODEMust be set to stdio for Claude DesktopYes
LOG_LEVELLogging level (error, warn, info, debug)No
DISABLE_CONSOLE_OUTPUTPrevents debug logs from interferingRecommended
N8N_API_URLYour n8n instance URL for workflow managementNo
N8N_API_KEYAPI key from n8n Settings → APINo

​
Disabling Telemetry

To opt out of anonymous usage statistics: 
npx n8n-mcp telemetry disable
Or add to your environment: 
"env": {
  "N8N_MCP_TELEMETRY_DISABLED": "true"
}

​
Troubleshooting

​
JSON Parsing Errors

If you see "Unexpected token..." errors:
  • Ensure MCP_MODE: "stdio" is set
  • Add DISABLE_CONSOLE_OUTPUT: "true"

​
npx Not Found

Verify Node.js is installed: 
node --version
npm --version

​
Updates

npx automatically uses the latest version. To force a fresh download: 
npx clear-npx-cache
npx n8n-mcp

​
Next Steps

Quickstart Guide

Learn how to use n8n-MCP with Claude

Docker Deployment

Deploy using Docker containers

Build docs developers (and LLMs) love

Get started for freeTalk to us