Mcp N8n Builder

mcp-n8n-builder

A Model Context Protocol (MCP) server for programmatic creation and management of n8n workflows. This server provides tools and resources for interacting with n8n's REST API, allowing AI assistants to build, modify, and manage workflows without direct user intervention.

Features

• 🔄 Workflow Management: Create, read, update, delete, activate, and deactivate workflows
• 📊 Execution Management: List and retrieve workflow execution details
• ✅ Schema Validation: Comprehensive validation with Zod for both input and output data
• 🔍 Node Validation: Validates node types against n8n's available nodes before workflow creation to prevent errors
• 🤔 Smart Suggestions: Provides suggestions for similar node types when invalid nodes are detected
• 🛠️ Error Handling: Detailed error messages for troubleshooting
• 📝 Documentation: Extensive documentation for all tools and resources
• 🔍 Search & Filter: Filter workflows by name, tags, or active status

⚠️ Token Consumption Warning

This tool is a "token monster" due to the nature of n8n workflows:

• N8N workflows are complex JSON structures with nested nodes, connections, parameters, and settings
• A single workflow can easily consume thousands of tokens when viewed or edited
• The JSON structure cannot be meaningfully reduced without losing essential workflow information
• LLM context windows are finite - complex workflows may exceed available context

Mitigation Strategies

The tool implements several optimizations to reduce token usage:

• Verbosity Control: Use OUTPUT_VERBOSITY=concise (default) for summaries instead of full JSON
• Object Simplification: Workflow listings show only essential fields (id, name, status, node count)
• **Selective Guid