n8n-mcp

Der umfassendste MCP-Server für n8n — 43 Tools, 8 Prompt-Vorlagen und 6 durchsuchbare Ressourcen, die die gesamte n8n REST-API abdecken. Die erste Python-Implementierung.

Geben Sie Claude (oder einem beliebigen MCP-kompatiblen KI-Client) die volle Kontrolle über Ihre n8n-Instanz: Erstellen Sie Workflows, führen Sie Ausführungen durch, verwalten Sie Anmeldedaten, fragen Sie Datentabellen ab, führen Sie Sicherheitsaudits durch — alles durch natürliche Sprache.

Highlights

• 43 MCP-Tools — Vollständiges CRUD für Workflows, Ausführungen, Anmeldedaten, Tags, Variablen und Datentabellen sowie Admin-Operationen wie Sicherheitsaudits und API-Funktionserkennung

• Doppelt validierte Workflow-Erstellung — create_and_validate_workflow führt eine 6-Phasen-Pipeline aus: Erstellung, strukturelle Rückleseprüfung, zwei Ausführungsdurchläufe, Konsistenzvergleich und ein PASS/FAIL-Urteil

• Schreibschutz standardmäßig aktiv — Alle verändernden Operationen sind deaktiviert, es sei denn, Sie aktivieren sie explizit mit N8N_MCP_WRITE_MODE=true

• 8 geführte Prompt-Vorlagen — Mehrstufige KI-Workflows für Debugging, Gesundheitschecks, Sicherheitsüberprüfungen, Workflow-Erstellung mit vollständigem Test und mehr

• Async & Paginiert — Basiert auf httpx mit cursor-basierter automatischer Paginierung und konfigurierbaren Timeouts

Funktionen

Plus 8 MCP-Prompt-Vorlagen und 6 durchsuchbare Ressourcen.

Voraussetzungen

• Python 3.10+

• n8n-Instanz — lokal (Docker) oder remote (Cloud-gehostet)

• n8n API-Schlüssel — generiert über die n8n-Einstellungen

Schnellstart

1. Klonen und installieren

git clone https://github.com/Siddharth0903/n8n-mcp.git
cd n8n-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

2. n8n starten (falls noch nicht geschehen)

docker compose up -d

Dies startet n8n mit PostgreSQL unter http://localhost:5678.

3. n8n API-Schlüssel abrufen

1. Öffnen Sie http://localhost:5678 in Ihrem Browser

2. Schließen Sie die Ersteinrichtung ab, falls es sich um eine neue Instanz handelt

3. Gehen Sie zu Settings (Zahnrad-Symbol) > n8n API

4. Klicken Sie auf Create an API key

5. Kopieren Sie den Schlüssel

4. Umgebung konfigurieren

cp .env.example .env

Bearbeiten Sie .env mit Ihren Werten:

N8N_MCP_BASE_URL=http://localhost:5678   # Your n8n URL
N8N_MCP_API_KEY=your-api-key-here        # The API key from step 3
N8N_MCP_WRITE_MODE=false                 # Set to 'true' to enable create/update/delete

5. Server ausführen

n8n-mcp

Der MCP-Server läuft nun über stdio und ist bereit für die Verbindung mit einem beliebigen MCP-Client.

Client-Integration

Claude Desktop

Hinzufügen zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "n8n": {
      "command": "/absolute/path/to/your/.venv/bin/n8n-mcp",
      "env": {
        "N8N_MCP_BASE_URL": "http://localhost:5678",
        "N8N_MCP_API_KEY": "your-api-key-here",
        "N8N_MCP_WRITE_MODE": "true"
      }
    }
  }
}

Tipp: Verwenden Sie den vollständigen absoluten Pfad zum n8n-mcp-Binary innerhalb Ihres virtualenv.

Claude Code (CLI)

claude mcp add n8n -- /absolute/path/to/your/.venv/bin/n8n-mcp

Oder fügen Sie es zur .mcp.json Ihres Projekts hinzu:

{
  "mcpServers": {
    "n8n": {
      "command": "/absolute/path/to/your/.venv/bin/n8n-mcp",
      "env": {
        "N8N_MCP_BASE_URL": "http://localhost:5678",
        "N8N_MCP_API_KEY": "your-api-key-here",
        "N8N_MCP_WRITE_MODE": "true"
      }
    }
  }
}

Beliebiger MCP-Client

n8n-mcp verwendet den Standard-MCP-stdio-Transport. Jeder MCP-kompatible Client kann eine Verbindung herstellen, indem er das n8n-mcp-Binary startet.

Konfiguration

Alle Einstellungen werden über Umgebungsvariablen (oder eine .env-Datei) konfiguriert:

MCP-Ressourcen

Durchsuchbare schreibgeschützte Ansichten Ihrer n8n-Daten:

MCP-Prompts

Geführte mehrstufige Vorlagen, die die KI durch komplexe Operationen leiten:

Sicherheit

• Schreibmodus ist standardmäßig AUS — nur Leseoperationen funktionieren, bis Sie explizit N8N_MCP_WRITE_MODE=true setzen

• Anmeldedaten-Geheimnisse werden niemals offengelegt — die n8n-API gibt nur Metadaten zurück, niemals geheime Werte

• Webhook-Pfad-Validierung — verhindert Pfad-Traversal- und SSRF-Angriffe

• Strukturierte Fehlerantworten — jeder Fehler gibt ein umsetzbares JSON mit Hinweisen zurück, keine rohen Exceptions

• Request-Timeouts — konfigurierbare Timeouts verhindern hängende Verbindungen

Architektur

Claude / MCP Client
        |
        v
  +-----------+
  |  n8n-mcp  |  FastMCP server (Python, async)
  |           |
  | 43 tools  |  Workflows, Executions, Credentials,
  | 6 rsrc    |  Tags, Variables, Data Tables, Admin
  | 8 prompts |
  +-----+-----+
        | httpx (async, paginated)
        v
  +-----------+
  |  n8n API  |  REST /api/v1
  +-----+-----+
        |
        v
  +-----------+
  | Workflows |
  |  & Data   |
  +-----------+

Entwicklung

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest -v

# Lint
ruff check src/ tests/

# Type check
mypy src/

Lizenz

MIT