⚡ n8n-MCP

The Bridge Between Workflow Automation and AI Intelligence

Overview • Quick Start • IDE Setup • Deployment • Documentation

🌟 Overview

n8n-MCP is a Model Context Protocol (MCP) server that empowers AI assistants (Claude, Cursor, etc.) with deep knowledge of n8n. It provides structured access to documentation, properties, and operations for over 1,200 nodes, enabling AI to build, validate, and manage your workflows with 100% accuracy.

✨ Key Features

📚 1,084+ Nodes Indexed: Full coverage of core and verified community nodes.
⚡ Proprietary Validation: Smart config checks that prevent runtime failures.
💡 Real-World Examples: 2,600+ pre-extracted configurations for instant use.
🎯 Template Library: 2,700+ workflow templates with smart discovery.
🤖 AI-Optimized: Designed for parallel execution and token efficiency.

🚀 Quick Start

Option 1: Hosted Service (Instant) ☁️

The fastest way to try n8n-MCP with zero setup.
👉 dashboard.n8n-mcp.com

Option 2: Local Setup (npx) 💻

Run directly in your terminal or connect to Claude Desktop:

npx n8n-mcp

Add to Claude Desktop (claude_desktop_config.json):

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

💻 IDE & Tool Support

n8n-MCP works seamlessly with these AI-powered environments:

Tool	Setup Guide
Claude Desktop	View Guide
Claude Code	View Guide
Cursor	View Guide
Windsurf	View Guide
VS Code	View Guide
Antigravity	View Guide

📦 Deployment Options

🐳 Docker (Recommended)

Ultra-optimized image (~120MB memory footprint).

docker pull ghcr.io/mutaharhashmi/n8n-mcp:latest

See Docker Guide for full configuration.

☁️ Railway (One-Click)

Deploy to the cloud in minutes.

🏗️ Local Installation (Developers)

git clone https://github.com/mutaharhashmi/n8n-mcp.git
cd n8n-mcp
npm install && npm run build && npm run rebuild

🛠️ n8n Integration

Take control of your n8n instance by adding API credentials to your environment:

N8N_API_URL=https://your-n8n-instance.com
N8N_API_KEY=your-api-key

This unlocks 13+ management tools to create, update, and test workflows directly from your AI assistant. See n8n Deployment Guide.

🤖 AI Orchestration (Pro Tip)

For the best results when using n8n-MCP with Claude Projects, use our Enhanced System Instructions. It teaches the AI to use parallel execution and multi-level validation for production-ready workflows.

📚 Documentation & Resources

Built with ❤️ by Mutahar Hashmi
_{Making AI + n8n workflow creation delightful}

n8n-MCP