ellmos-ai/n8n-manager-mcp

**🇩🇪 Deutsche Version**
*Part of the ellmos-ai family and the open-bricks umbrella.*
> [!NOTE]
> **For AI Assistants & LLMs:** An llms.txt index file is available in the root directory for fast context ingestion, tool catalog references, and directory listings.
MCP (Model Context Protocol) server for managing n8n workflows via AI assistants like Claude, Cursor, and Windsurf.
Quick Navigation
| Nr | Section | Highlights |
| :--- | :--- | :--- |
| 01 | 📐 System Architecture & Topology (#system-architecture) | Local stdio transport, multi-server routing, and safety middleware |
| 02 | 📊 Dual Mermaid Diagrams (#dual-mermaid-diagrams) | Component Architecture flowchart TD & Safe Mutation Lifecycle sequence diagram |
| 03 | 🌐 Directory Status & Registries (#directory-status) | Official listings on npm, Glama, PulseMCP, and Enterprise DNA |
| 04 | 🎯 Target Personas & Discoverability (#target-personas--discoverability) | Persona mapping [PERSONA-01] to [PERSONA-04] and High-Intent SEO queries |
| 05 | ⚖️ Comparative Matrix & Alternatives (#comparative-matrix--alternatives) | 10-dimension evaluation vs raw REST API, shell CLI, browser UI, and cloud SaaS |
| 06 | 🛡️ Core Capabilities & Safety Invariants (#core-capabilities--safety-invariants) | 10 formal invariants (INV-LOCAL-01 to INV-SLA-10), read-only gates, audit logs |
| 07 | ✨ Key Features (#features) | Direct REST integration, multi-server routing, backup snapshots, node catalog |
| 08 | ⚙️ Client Installation (#installation) | One-command setup for Claude Code, Claude Desktop, Cursor, and Windsurf |
| 09 | 🚀 Quick Start (#quick-start) | Step-by-step workflow creation, execution inspection, and server switching |
| 10 | 🛠️ Available Tools (19 Tools) (#available-tools) | Complete MCP tool reference across CRUD, executions, backups, and nodes |
| 11 | 🔗 Optional: n8n-workflow-manager Seam (#optional-n8n-workflow-manager-seam) | Decision tracking and change history integration with paired manager service |
| 12 | 🔒 Configuration & Safety Defaults (#configuration) | Environment variables, local backup root, and strict monotonic constraints |
| 13 | 🧪 Development & Testing (#development) | Multi-OS Vitest test suite, smoke runner, and offline node catalog tests |
| 14 | 🧱 ellmos-ai Ecosystem (#ellmos-ai-ecosystem) | Sibling MCP servers, BACH agent OS, and open-bricks desktop software suites |
| 15 | 📜 Third-Party Licenses & Transparency (#third-party-licenses--transparency) | 100% permissive open-source dependencies (MIT, BSD, Apache-2.0) |
| 16 | 📈 Marketing & Personas Log (#marketing--personas-log) | Comprehensive positioning log, keyword matrix, and 3-phase roadmap |
| 17 | 📝 Changelog (#changelog) | Complete release notes, security hardenings, and discoverability history |
| 18 | ⚖️ Liability / Haftung (#haftung--liability) | Statutory open-source donation notice under §§ 516 ff. BGB, MIT disclaimer, 48h SLA |
---
System Architecture
The n8n Manager MCP Server operates as a **local-first, stdio-connected bridge** between AI development environments (Claude Code, Claude Desktop, Cursor, Windsurf) and local or remote n8n instances.
- **Process Model:** Runs purely in user space (RunAsInvoker) as a dedicated Node.js child process communicating via standard input/output (stdio) using JSON-RPC 2.0.
- **Fail-Closed Safety Middleware:** Every mutation tool call passes through an immutable safety gate before contacting n8n APIs or touching the filesystem.
- **Multi-Instance Router:** Seamlessly targets independent n8n instances (development, staging, production) with isolated API credentials and atomic configuration persistence.
- **Offline Node Catalog:** Provides instantaneous node schema introspection (n8n_describe_nodes) without incurring API latency or network calls.
Architectural Topology Projection (4-View Model)
---
Dual Mermaid Diagrams
Component Architecture
Safe Workflow Mutation Lifecycle
---
Directory Status
- npm package: published as n8n-manager-mcp
- Glama listing: public directory page for the ellmos-ai repo
- Enterprise DNA directory: additional public directory entry for ellmos-ai/n8n-manager-mcp
- PulseMCP listing: indexed as ellmos-ai-n8n-manager
- MCP namespace status: this repo contains server.json and mcpName metadata for io.github.ellmos-ai/n8n-manager-mcp; some ecosystem directories still expose the legacy io.github.lukisch/n8n-manager-mcp name until their indexes refresh.
- Search context: best matched by n8n MCP server, n8n workflow management MCP, AI assistant n8n workflows, and ellmos-ai n8n-manager-mcp.