leonardosepulvedat/mcp-n8n

**Operate and build n8n from Cursor or Claude** — administration of your instance (users, projects, executions, audit) **and** a full builder loop: a catalog of **560 nodes with real parameter schemas** extracted from the official n8n packages, validation before saving, automatic repair, snapshots with rollback and diff, per-node execution debugging, health reports, and full-instance backup.
Two env vars. Runs on your machine (stdio) or as a remote HTTP server. No hosted account.
---
🎯 Token Optimization
**This server is optimized to minimize token consumption**, addressing one of the biggest issues with MCP servers - excessive API token usage.
What We've Optimized:
- **90% reduction** in tokens for workflow listing with new n8n_list_workflows_summary endpoint
- **Field filtering** - request only the data you need
- **Smart defaults** - reduced from 100 to 10-20 results per query
- **Intelligent warnings** - alerts when operations will consume significant tokens
**See TOKEN_OPTIMIZATION.md for detailed usage guide.**
---
✨ Features
🔄 Workflow Management
- **Create & Deploy**: Build workflows with natural language descriptions
- **CRUD Operations**: Full lifecycle management (Create, Read, Update, Delete)
- **Activation Control**: Enable/disable workflows on demand
- **Project Transfer**: Move workflows between projects seamlessly
- **Tag Management**: Organize workflows with custom tags
📊 Execution Monitoring
- **Real-time Tracking**: Monitor workflow executions with advanced filters
- **Detailed Insights**: Access full execution data and logs
- **Error Recovery**: Retry failed executions automatically
- **Cleanup Tools**: Manage execution history efficiently
🔐 Credential Management
- **Secure Creation**: Add credentials for any service
- **Schema Discovery**: Auto-discover required fields for credential types
- **Project Isolation**: Transfer credentials between projects safely
- **Type Support**: Compatible with all n8n credential types
🧱 Workflow Builder
- **Full node catalog — 560 nodes with real schemas**: extracted directly from n8n-nodes-base and @n8n/n8n-nodes-langchain (parameters with types, allowed options, display conditions, credentials, latest typeVersion), regenerated weekly by CI. Search with n8n_search_nodes, inspect with n8n_get_node
- **Real validation**: n8n_validate_workflow checks against the real schemas — nonexistent node types, missing required params (including conditionally required ones), invalid option values, wrong typeVersion, broken connections — *before* save/activate
- **Expression linting**: detects {{ }} expressions missing the = prefix and references to nodes that don't exist in the workflow
- **Automatic repair**: n8n_autofix_workflow fixes missing typeVersion/positions, duplicate names, dangling connections and expression prefixes — preview first, apply with a snapshot
- **Surgical edits**: n8n_update_workflow_partial adds/removes nodes and connections without rewriting the whole flow
- **Public templates**: search and import from n8n.io (n8n_search_public_templates, n8n_import_public_template) plus 100 bundled templates as a fallback
- **Guided prompts**: MCP prompts build-workflow and fix-workflow walk any agent through the full build/validate/test/repair loop
🔬 Deep Debugging & Health
- **Per-node execution data**: n8n_get_node_execution_data shows exactly what data flowed through one node (status, item counts, output samples, error details) without downloading the whole execution
- **Debug loop**: n8n_debug_last_error returns the failing node and message from the last error
- **Health reports**: n8n_workflow_health computes success rate, failure count, average duration and last failure per workflow from recent executions, sorted worst-first
🛡️ Safety Net & Real Testing
- **Automatic snapshots**: before every update, partial edit, autofix, or delete, the previous state is saved locally (~/.mcp-n8n/snapshots, configurable with N8N_SNAPSHOT_DIR)