n8n-MCP Server

n8n-MCP

A Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to n8n node documentation, properties, and operations. Deploy in minutes to give Claude and other AI assistants deep knowledge about n8n's 1,236 workflow automation nodes (806 core + 430 community).

Overview

n8n-MCP serves as a bridge between n8n's workflow automation platform and AI models, enabling them to understand and work with n8n nodes effectively. It provides structured access to:

• 📚 1,084 n8n nodes - 537 core nodes + 547 community nodes (301 verified)
• 🔧 Node properties - 99% coverage with detailed schemas
• ⚡ Node operations - 63.6% coverage of available actions
• 📄 Documentation - 87% coverage from official n8n docs (including AI nodes)
• 🤖 AI tools - 265 AI-capable tool variants detected with full documentation
• 💡 Real-world examples - 2,646 pre-extracted configurations from popular templates
• 🎯 Template library - 2,709 workflow templates with 100% metadata coverage
• 🌐 Community nodes - Search verified community integrations with source filter (NEW!)

⚠️ Important Safety Warning

NEVER edit your production workflows directly with AI! Always:

• 🔄 Make a copy of your workflow before using AI tools
• 🧪 Test in development environment first
• 💾 Export backups of important workflows
• ⚡ Validate changes before deploying to production

AI results can be unpredictable. Protect your work!

🚀 Quick Start

Option 1: Hosted Service (Easiest - No Setup!) ☁️

The fastest way to try n8n-MCP - no installation, no configuration:

👉 dashboard.n8n-mcp.com

• ✅ Free tier: 100 tool calls/day
• ✅ Instant access: Start building workflows immediately
• ✅ Always up-to-date: Latest n8n nodes and templates
• ✅ No infrastructure: We handle everything

Just sign up, get your API key, and connect your MCP client.

🏠 Self-Hosting Options

Prefer to run n8n-MCP yourself? Choose your deployment method:

Option A: npx (Quick Local Setup) 🚀

Get n8n-MCP running in minutes:

Prerequisites: Node.js installed on your system

# Run directly with npx (no installation needed!)
npx n8n-mcp

Add to Claude Desktop config:

⚠️ Important: 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. This variable ensures that only JSON-RPC messages are sent to stdout, preventing debug logs from interfering with the protocol.

Basic configuration (documentation tools only):

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true"
      }
    }
  }
}

Full configuration (with n8n management tools):

{
  "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"
      }
    }
  }
}

Note: npx will download and run the latest version automatically. The package includes a pre-built database with all n8n node information.

Configuration file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Restart Claude Desktop after updating configuration - That's it! 🎉

Option B: Docker (Isolated & Reproducible) 🐳

Prerequisites: Docker installed on your system