MCP n8n Server

Betreiben und erstellen Sie n8n von Cursor oder Claude aus – Verwaltung Ihrer Instanz (Benutzer, Projekte, Ausführungen, Audit) und ein vollständiger Builder-Loop: ein Katalog von 560 Nodes mit echten Parameterschemata, extrahiert aus den offiziellen n8n-Paketen, Validierung vor dem Speichern, automatische Reparatur, Snapshots mit Rollback und Diff, Debugging der Ausführungsdaten pro Node, Health-Berichte und Backup der gesamten Instanz.

Zwei Umgebungsvariablen. Läuft auf Ihrem Rechner (stdio) oder als Remote-HTTP-Server. Kein gehostetes Konto.

🎯 Token-Optimierung

Dieser Server ist darauf optimiert, den Token-Verbrauch zu minimieren und geht damit eines der größten Probleme mit MCP-Servern an – den übermäßigen Verbrauch von API-Tokens.

Was wir optimiert haben:

• 90 % weniger Tokens für die Workflow-Auflistung mit dem neuen Endpunkt n8n_list_workflows_summary

• Feldfilterung – nur die Daten anfordern, die Sie benötigen

• Intelligente Standardwerte – von 100 auf 10–20 Ergebnisse pro Abfrage reduziert

• Intelligente Warnungen – Hinweise, wenn Vorgänge erhebliche Tokens verbrauchen

Eine ausführliche Anleitung finden Sie in TOKEN_OPTIMIZATION.md.

Related MCP server: n8n Workflow Builder

✨ Funktionen

🔄 Workflow-Verwaltung

• Erstellen & Bereitstellen: Workflows mit natürlichsprachlichen Beschreibungen erstellen

• CRUD-Operationen: Vollständiges Lebenszyklus-Management (Create, Read, Update, Delete)

• Aktivierungssteuerung: Workflows bei Bedarf aktivieren/deaktivieren

• Projektübertragung: Workflows nahtlos zwischen Projekten verschieben

• Tag-Verwaltung: Workflows mit benutzerdefinierten Tags organisieren

📊 Ausführungsüberwachung

• Echtzeit-Tracking: Workflow-Ausführungen mit erweiterten Filtern überwachen

• Detaillierte Einblicke: Zugriff auf vollständige Ausführungsdaten und Protokolle

• Fehlerbehebung: Fehlgeschlagene Ausführungen automatisch erneut versuchen

• Bereinigungswerkzeuge: Ausführungsverlauf effizient verwalten

🔐 Credential-Verwaltung

• Sicheres Erstellen: Credentials für jeden Dienst hinzufügen

• Schema-Erkennung: Pflichtfelder für Credential-Typen automatisch erkennen

• Projektisolierung: Credentials sicher zwischen Projekten übertragen

• Typunterstützung: Kompatibel mit allen n8n-Credential-Typen

🧱 Workflow-Builder

• Vollständiger Node-Katalog – 560 Nodes mit echten Schemata: direkt aus n8n-nodes-base und @n8n/n8n-nodes-langchain extrahiert (Parameter mit Typen, zulässigen Optionen, Anzeigebedingungen, Credentials, aktueller typeVersion), wöchentlich von CI neu generiert. Suchen mit n8n_search_nodes, prüfen mit n8n_get_node

• Echte Validierung: n8n_validate_workflow prüft anhand der echten Schemata – nicht vorhandene Node-Typen, fehlende Pflichtparameter (einschließlich bedingt erforderlicher), ungültige Optionswerte, falsche typeVersion, defekte Verbindungen – vor dem Speichern/Aktivieren

• Expression-Linting: erkennt {{ }}-Ausdrücke ohne das =-Präfix und Verweise auf Nodes, die im Workflow nicht existieren

• Automatische Reparatur: n8n_autofix_workflow behebt fehlende typeVersion/Positionen, doppelte Namen, verwaiste Verbindungen und Expressions-Präfixe – zuerst Vorschau anzeigen, dann mit Snapshot anwenden

• Chirurgische Bearbeitungen: n8n_update_workflow_partial fügt Nodes und Verbindungen hinzu/entfernt sie, ohne den gesamten Workflow neu zu schreiben

• Öffentliche Vorlagen: Suche und Import von n8n.io (n8n_search_public_templates, n8n_import_public_template) plus 100 gebündelte Vorlagen als Fallback

• Geführte Prompts: Die MCP-Prompts build-workflow und fix-workflow führen jeden Agenten durch den vollständigen Build-/Validierungs-/Test-/Reparatur-Loop

🔬 Tiefes Debugging & Health

• Ausführungsdaten pro Node: n8n_get_node_execution_data zeigt genau, welche Daten durch einen Node geflossen sind (Status, Item-Anzahl, Ausgabebeispiele, Fehlerdetails), ohne die gesamte Ausführung herunterzuladen

• Debug-Loop: n8n_debug_last_error liefert den fehlgeschlagenen Node und die Meldung des letzten Fehlers

• Health-Berichte: n8n_workflow_health berechnet Erfolgsquote, Anzahl der Fehler, durchschnittliche Dauer und letzten Fehler pro Workflow aus aktuellen Ausführungen, sortiert nach den schlechtesten zuerst

🛡️ Sicherheitsnetz & echte Tests

• Automatische Snapshots: Vor jeder Aktualisierung, Teilbearbeitung, Autofix oder Löschung wird der vorherige Zustand lokal gespeichert (~/.mcp-n8n/snapshots, konfigurierbar mit N8N_SNAPSHOT_DIR)

• Rollback: n8n_rollback_workflow stellt jeden Snapshot wieder her – und erstellt sogar einen gelöschten Workflow neu (recreate=true)

• Diff: n8n_diff_workflow_snapshot vergleicht einen Snapshot mit dem aktuellen Zustand (hinzugefügte/entfernte/geänderte Nodes, geänderte Parameter, Verbindungsänderungen), bevor Sie sich für ein Rollback entscheiden

• Backup der gesamten Instanz: n8n_export_all_workflows speichert jeden Workflow als JSON-Datei; n8n_import_workflows stellt sie wieder her

• End-to-End-Tests: n8n_trigger_webhook ruft einen Webhook-Trigger-Workflow auf der Instanz auf und gibt die echte HTTP-Antwort zurück, sodass der Agent überprüfen kann, ob der Workflow tatsächlich funktioniert

🎯 Gebündelte Vorlagen

• 100 lokale Ausgangspunkte mit Stichwortsuche, falls Sie n8n.io nicht ansprechen möchten

🏗️ Organisation & Verwaltung

• Tags: Ressourcen kategorisieren und organisieren

• Variablen: Zentrale Verwaltung von Umgebungsvariablen

• Projekte: Unterstützung für Multi-Tenant-Projekte

• Benutzer & Berechtigungen: Vollständige Zugriffskontrollverwaltung

• Audit-Protokolle: Sicherheits- und Compliance-Berichte erstellen

🚀 Schnellstart

Installation über npm (empfohlen)

Dies ist der einfachste Weg, um loszulegen:

npm install -g mcp-n8n

Konfiguration

1. Holen Sie sich Ihre n8n-API-Credentials:

   • Navigieren Sie zu Ihrer n8n-Instanz → Einstellungen → n8n API

   • Generieren Sie einen neuen API-Schlüssel

2. Claude Desktop konfigurieren:

Fügen Sie Folgendes zu ~/Library/Application Support/Claude/claude_desktop_config.json (Mac/Linux) oder %APPDATA%\Claude\claude_desktop_config.json (Windows) hinzu:

Option A – Globale Installation verwenden (falls Sie npm install -g mcp-n8n ausgeführt haben):

{
  "mcpServers": {
    "n8n": {
      "command": "mcp-n8n",
      "env": {
        "N8N_BASE_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here",
        "N8N_TOOLSETS": "all"
      }
    }
  }
}

N8N_TOOLSETS ist optional (Standard: all). Verwenden Sie core,builder, wenn Sie Operationen + Erstellung ohne Benutzer-/Projekt-Admin-Werkzeuge möchten. Verwenden Sie admin nur für die Instanzverwaltung.

Remote-HTTP-Modus (optional)

Standardmäßig kommuniziert der Server über stdio (lokal). Um ihn als gemeinsamen Remote-Server auszuführen (z. B. in Docker oder auf einem VPS), legen Sie einen Port fest:

N8N_BASE_URL=https://your-n8n-instance.com \
N8N_API_KEY=your-api-key \
N8N_MCP_HTTP_PORT=3000 \
N8N_MCP_HTTP_TOKEN=some-strong-secret \
mcp-n8n

Dadurch wird das MCP-Protokoll über streamable HTTP auf Port 3000 bereitgestellt, zusätzlich zu einem GET /health-Endpunkt. N8N_MCP_HTTP_TOKEN wird dringend empfohlen: Wenn gesetzt, muss jede Anfrage Authorization: Bearer <token> enthalten. Richten Sie jeden MCP-Client, der streamable HTTP unterstützt, mit diesem Header auf http://your-host:3000 aus.

Option B – npx verwenden (keine Installation erforderlich, immer die neueste Version):

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "mcp-n8n"],
      "env": {
        "N8N_BASE_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Cursor konfigurieren:

Fügen Sie Folgendes zu den Cursor-MCP-Einstellungen hinzu (Einstellungen → Erweiterungen → MCP):

Empfohlen – npx verwenden (verwendet immer die neueste Version):

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "mcp-n8n"],
      "env": {
        "N8N_BASE_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Hinweis: Cursor erfordert die Verwendung von npx für MCP-Server. Das -y-Flag installiert/aktualisiert das Paket automatisch, ohne nachzufragen.

Option C – Docker:

docker build -t mcp-n8n .

{
  "mcpServers": {
    "n8n": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "N8N_BASE_URL", "-e", "N8N_API_KEY",
        "-v", "mcp-n8n-data:/data",
        "mcp-n8n"
      ],
      "env": {
        "N8N_BASE_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Das /data-Volume speichert Workflow-Snapshots zwischen den Läufen.

4. Starten Sie Claude Desktop oder Cursor neu

💬 Anwendungsbeispiele

Nach der Konfiguration können Sie über natürliche Sprache mit n8n interagieren:

Workflows erstellen

"Create a workflow that monitors my Gmail inbox and sends
Slack notifications for important emails"

"Build a daily report workflow that pulls data from my database,
generates charts, and emails them to my team"

Vorlagen verwenden

"I need a WhatsApp chatbot with AI for customer support"
→ Automatically creates workflow from "WhatsApp AI Response Bot" template

"Create an automated stock analysis workflow"
→ Uses "Automated Stock Analysis with GPT-4" template

Workflows verwalten

"Show me all active workflows in the production project"
→ Uses n8n_list_workflows_summary for efficient token usage

"Show me the details of workflow abc123"
→ Uses n8n_get_workflow to fetch complete details only when needed

"Deactivate the 'Daily Backup' workflow"

"What went wrong with execution abc123?"

Überwachung & Debugging

"Show me the last 10 failed executions"

"Retry all failed executions from workflow xyz456"

"Delete all successful executions older than 30 days"

🛠️ Verfügbare Werkzeuge

• n8n_create_workflow - Neue Workflows erstellen (vorher validieren)

• n8n_list_workflows_summary - Token-effiziente Auflistung

• n8n_list_workflows - Vollständige Details mit optionaler Feldfilterung

• n8n_get_workflow - Vollständiges Workflow-JSON

• n8n_update_workflow - Felder ersetzen (ausgelassene Felder behalten aktuelle Werte)

• n8n_update_workflow_partial - Chirurgische Bearbeitungen: Nodes und Verbindungen hinzufügen/entfernen

• n8n_delete_workflow - Workflows dauerhaft entfernen

• n8n_activate_workflow / n8n_deactivate_workflow

• n8n_transfer_workflow / Tag-Werkzeuge

• n8n_list_workflow_snapshots - Lokaler Verlauf jeder über diesen Server vorgenommenen Änderung

• n8n_rollback_workflow - Eine frühere Version wiederherstellen oder einen gelöschten Workflow neu erstellen

• n8n_diff_workflow_snapshot - Einen Snapshot vor dem Rollback mit dem aktuellen Zustand vergleichen

• n8n_trigger_webhook - Einen Webhook-Workflow aufrufen und die echte Antwort erhalten

• n8n_export_all_workflows / n8n_import_workflows - Backup und Wiederherstellung der gesamten Instanz

• n8n_search_nodes / n8n_get_node - Vollständiger Katalog: 560 Nodes mit echten Parameterschemata

• n8n_validate_workflow - JSON vor dem Speichern/Aktivieren gegen echte Schemata prüfen

• n8n_autofix_workflow - Mechanische Reparaturen: typeVersion, Positionen, Duplikate, verwaiste Verbindungen, Expressions-Präfixe

• n8n_search_public_templates / n8n_import_public_template - Offizielle n8n.io-Bibliothek

• n8n_list_workflow_templates / n8n_get_workflow_template / n8n_create_workflow_from_template - Gebündelte Vorlagen

100 enthaltene Vorlagen in 13 Kategorien:

• E-Commerce: Shopify-Automatisierung, WooCommerce-Support-Agenten

• Soziale Medien: Instagram-, TikTok-, LinkedIn-, Twitter-Automatisierung

• KI/Chat: Chatbots, KI-Agenten, Sprachassistenten

• Kommunikation: WhatsApp-, Telegram-, E-Mail-Automatisierung

• Content: Blog-Automatisierung, Videogenerierung, SEO-Optimierung

• HR/Recruiting: Lebenslauf-Screening, Kandidatensuche

• Vertrieb/CRM: Lead-Generierung, Cold-Calling-Pipelines

• Finanzen: Aktienanalyse, Rechnungsextraktion

• Datenextraktion: Google Maps, LinkedIn, Amazon, TikTok

• Überwachung: Website-Verfügbarkeit, Wettbewerbs-Tracking

• Produktivität: Kalender-, Notion-, Terminplanungs-Automatisierung

• n8n_list_executions - Nach Status, Workflow, Projekt filtern

• n8n_get_execution - Detaillierte Ausführungsdaten

• n8n_delete_execution - Ausführungsdatensätze entfernen

• n8n_retry_execution - Fehlgeschlagene Ausführungen erneut versuchen

• n8n_debug_last_error - Fehlgeschlagener Node + Meldung des letzten Fehlers

• n8n_get_node_execution_data - Daten, die durch einen bestimmten Node geflossen sind

• n8n_workflow_health - Erfolgsquote, Fehler und Dauer pro Workflow

• n8n_create_credential - Neue Credentials hinzufügen

• n8n_delete_credential - Credentials entfernen (nur Besitzer)

• n8n_get_credential_schema - Pflichtfelder ermitteln

• n8n_transfer_credential - Zwischen Projekten verschieben

Tags: Erstellen, auflisten, abrufen, aktualisieren, löschen Variablen: Erstellen, auflisten, aktualisieren, löschen Benutzer: Auflisten, erstellen, abrufen, löschen, Rolle ändern Projekte: Erstellen, auflisten, aktualisieren, löschen, Benutzer verwalten

• n8n_generate_audit - Sicherheits-Audit-Berichte

• n8n_pull_source_control - Versionskontroll-Integration

61 Werkzeuge standardmäßig (N8N_TOOLSETS=all). core,builder stellt 28 bereit. Dazu 2 MCP-Prompts (build-workflow, fix-workflow).

📚 Dokumentation

• Schnellstart-Anleitung – In 5 Minuten startklar

• Beispiele & Anwendungsfälle – Praxisnahe Automatisierungsbeispiele

• Node-Referenz – Detaillierte Werkzeugdokumentation

• Changelog – Versionshistorie und Aktualisierungen

🏗️ Projektstruktur

mcp-n8n/
├── src/
│   ├── index.ts          # MCP server implementation
│   ├── n8n-client.ts     # n8n API client
│   └── types.ts          # TypeScript definitions
├── examples/
│   ├── templates-metadata.json
│   └── *.json            # Pre-built workflow templates
├── dist/                 # Compiled output
├── QUICKSTART.md         # Quick start guide
├── EXAMPLES.md           # Usage examples
├── NODE_REFERENCE.md     # API documentation
└── package.json

🔧 Entwicklung

Lokale Installation (für die Entwicklung)

Wenn Sie einen Beitrag leisten oder lokale Änderungen testen möchten:

1. Einrichtung

# Clone repository
git clone https://github.com/leonardosepulvedat/mcp-n8n.git
cd mcp-n8n

# Install dependencies
npm install

# Build
npm run build

# Development with auto-rebuild
npm run watch

2. Mit lokalem Build konfigurieren

Für Claude Desktop füge Folgendes zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-n8n/dist/index.js"],
      "env": {
        "N8N_BASE_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Für Cursor füge Folgendes zu den MCP-Einstellungen hinzu:

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-n8n/dist/index.js"],
      "env": {
        "N8N_BASE_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Wichtig: Ersetze /absolute/path/to/mcp-n8n/ durch den tatsächlichen absoluten Pfad zu deinem geklonten Repository (z. B. /Users/yourname/projects/mcp-n8n/).

3. Testen

# Set environment variables
cp .env.example .env
# Edit .env with your credentials

# Build and test
npm run build
node dist/index.js

Ausführen

Um das Hauptskript auszuführen, führe Folgendes aus:

python main.py

Testen

Um die Tests auszuführen, führe Folgendes aus:

pytest test_main.py

📋 Voraussetzungen

• Node.js: 20 oder höher

• n8n-Instanz: Selbst gehostet oder n8n Cloud (kostenpflichtiger Plan)

• n8n-API-Schlüssel: Für die Authentifizierung erforderlich

• KI-IDE: Claude Desktop oder Cursor mit MCP-Unterstützung

n8n-Voraussetzungen

• Selbst gehostet: Voller API-Zugriff ✅

• n8n Cloud: Für den API-Zugriff ist ein kostenpflichtiger Plan erforderlich

• Version: Kompatibel mit n8n v1.0.0+

🤝 Mitwirken

Beiträge sind willkommen! Reiche gerne einen Pull Request ein.

1. Forke das Repository

2. Erstelle deinen Feature-Branch (git checkout -b feature/AmazingFeature)

3. Committe deine Änderungen (git commit -m 'Add some AmazingFeature')

4. Pushe den Branch (git push origin feature/AmazingFeature)

5. Öffne einen Pull Request

📝 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten findest du in der Datei LICENSE.

🙏 Danksagungen

• n8n – Die Workflow-Automatisierungsplattform

• Anthropic – Claude und Model Context Protocol

• Cursor – KI-gestützter Code-Editor

🔗 Ressourcen

• n8n-API-Dokumentation

• Model Context Protocol

• n8n-Community

• MCP Servers Registry

⚠️ Wichtige Hinweise

API-Zugriff

• n8n Cloud erfordert einen kostenpflichtigen Plan, um auf die API zugreifen zu können

• Selbst gehostetes n8n bietet in allen Plänen vollen API-Zugriff

• Einige Vorgänge erfordern Besitzer-/Admin-Berechtigungen

Sicherheit

• Committe niemals .env-Dateien mit Zugangsdaten

• Verwende Umgebungsvariablen für sensible Daten

• API-Schlüssel gewähren vollen Zugriff auf deine n8n-Instanz

• Rotiere API-Schlüssel regelmäßig aus Sicherheitsgründen

Ratenbegrenzung

• Beachte die API-Ratenlimits von n8n

• Verwende Paginierung für große Ergebnismengen

• Implementiere eine Fehlerbehandlung für Ratenlimit-Antworten

🐛 Fehlerbehebung

Verbindungsprobleme

Problem: „Verbindung zur n8n-API nicht möglich“

• Überprüfe, ob N8N_BASE_URL korrekt und erreichbar ist

• Prüfe, ob der API-Schlüssel gültig ist

• Stelle sicher, dass die n8n-Instanz läuft

Berechtigungsfehler

Problem: „Unzureichende Berechtigungen“

• Einige Vorgänge erfordern die Rolle Besitzer/Admin

• Überprüfe, ob dein Benutzer über die entsprechenden Berechtigungen verfügt

• Prüfe die Zugriffsrechte auf Projektebene

Vorlagenprobleme

Problem: „Vorlage nicht gefunden“

• Stelle sicher, dass das Verzeichnis examples/ vorhanden ist

• Prüfe, ob templates-metadata.json existiert

• Überprüfe, ob die Referenzen auf Vorlagendateien korrekt sind

💡 Tipps & Best Practices

1. Beginne mit Vorlagen: Verwende vorgefertigte Vorlagen als Ausgangspunkt

2. Verwende Tags: Organisiere Workflows mit Tags für eine einfache Verwaltung

3. Überwache Ausführungen: Prüfe regelmäßig fehlgeschlagene Ausführungen

4. Räume auf: Entferne alte Ausführungsdaten, um Speicherplatz zu sparen

5. Versionskontrolle: Nutze die integrierten Versionskontrollfunktionen von n8n

6. Erst testen: Teste Workflows, bevor du sie in der Produktion aktivierst

📧 Support

• Issues: GitHub Issues

• Discussions: GitHub Discussions

• n8n-Community: community.n8n.io

⬆ Zurück nach oben