n8n MCP Setup - Multi-Editor Edition

Enhanced setup wizard for configuring n8n-mcp across multiple AI editors and IDEs.

Supported Editors

• ✅ Claude Desktop - ~/.claude/desktop_config.json
• ✅ Claude Code (CLI) - ~/.claude/settings.json
• ✅ Cursor - ~/.cursor/mcp_config.json
• ✅ Windsurf - ~/.windsurf/mcp_config.json
• ✅ Continue - ~/.continue/config.json
• ✅ Roo Code - ~/.roo/mcp_config.json
• ✅ Generic/Other - Custom path support

Usage

Local Usage

node n8n-mcp-setup-multi/index.js

Global Installation

npm install -g /path/to/n8n-mcp-setup-multi
n8n-mcp-setup-multi

Via npx (after publishing)

npx n8n-mcp-setup-multi

What It Does

1. Editor Selection - Choose your target AI editor/IDE
2. n8n Detection - Auto-detects n8n at http://localhost:5678
3. API Key Setup - Validates n8n API authentication
4. Config Generation - Creates MCP server configuration
5. Auto-Save - Writes config to the correct location for your editor

Generated Configuration

The wizard generates an MCP server configuration:

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["-y", "n8n-mcp@latest"],
      "env": {
        "N8N_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key"
      }
    }
  }
}

Environment File

Also generates .env.n8n-mcp with:

• N8N_URL - Your n8n instance URL
• N8N_API_KEY - Your n8n API key
• MCP_SERVER_PORT - MCP server port (default: 3000)

Available MCP Tools

After setup, these tools are available in your editor:

• n8n_list_workflows - List all n8n workflows
• n8n_get_workflow - Get workflow details
• n8n_execute_workflow - Execute a workflow
• n8n_search_nodes - Search n8n nodes
• n8n_get_node_info - Get node documentation
• n8n_create_workflow - Create new workflow
• n8n_update_workflow - Update existing workflow

Example Workflow

# Run the setup wizard
node n8n-mcp-setup-multi/index.js

# Select your editor (e.g., Claude Code)
# Confirm n8n URL: http://localhost:5678
# Enter API key if prompted
# Save configuration

# Restart your editor
# MCP tools are now available!

Adding Support for New Editors

Edit index.js and add to the EDITORS object:

const EDITORS = {
  // ... existing editors

  my_editor: {
    label: 'My Editor',
    configPath: () => path.join(os.homedir(), '.my-editor', 'config.json'),
    formatConfig: (n8nUrl, n8nApiKey) => ({
      mcpServers: {
        'n8n-mcp': {
          command: 'npx',
          args: ['-y', 'n8n-mcp@latest'],
          env: {
            N8N_URL: n8nUrl,
            N8N_API_KEY: n8nApiKey || ''
          }
        }
      }
    }),
    postInstall: ['Restart My Editor', 'Enable MCP in settings']
  }
};

Troubleshooting

n8n not detected

• Ensure n8n is running: docker ps | grep n8n
• Check n8n URL is accessible: curl http://localhost:5678/healthz

API key verification failed

• Verify API key in n8n Settings → API
• Check API key has correct permissions

Config not applied

• Restart your editor/IDE completely
• Check config file exists and is valid JSON
• Clear editor cache if needed

Documentation

Full n8n-mcp documentation: https://github.com/czlonkowski/n8n-mcp

License

MIT