mcp-n8n-workflow-builder

Converts conversational English descriptions into executable n8n workflow JSON through Claude AI integration via MCP protocol. The system parses natural language intent, maps it to n8n node types and configurations, and generates valid workflow definitions without requiring manual JSON editing. Uses Claude's reasoning capabilities to decompose complex automation requests into sequential workflow steps with proper node connections and data mapping.

Manages and routes workflow operations across multiple n8n instances through a unified MCP interface, allowing users to create, deploy, and monitor workflows on different n8n deployments from a single conversation. The system maintains instance-specific credentials and API endpoints, routing each operation to the correct target instance based on user intent or explicit selection.

Automatically generates human-readable documentation for workflows including purpose, steps, data flow, and integration points. The system analyzes workflow structure, extracts node configurations, and produces markdown or HTML documentation that explains what the workflow does and how it works. Supports custom documentation templates and multi-language output.

Analyzes workflow execution metrics and identifies performance bottlenecks, suggesting optimizations such as parallel execution, caching, or node consolidation. The system collects execution time data per node, identifies slow steps, and recommends architectural changes to improve throughput and reduce latency. Supports comparative analysis across multiple executions.

Manages workflow triggers including webhooks, scheduled execution, and event-based activation. The system configures webhook endpoints, generates unique URLs, sets up cron schedules, and integrates with external event sources. Supports trigger validation and testing to ensure workflows activate correctly.

Assists in configuring data transformations between workflow nodes, including field mapping, type conversion, and expression-based transformations. The system understands data schemas from source and target nodes, suggests mappings, and generates transformation expressions. Supports JSONata and JavaScript expressions for complex transformations.

Enables sharing of workflows with team members, managing access permissions, and tracking changes. The system manages workflow ownership, access control lists, and version history. Supports commenting on workflows and change notifications to keep teams synchronized.

Enables rapid workflow scaffolding by selecting from predefined templates or generating custom templates based on common automation patterns. The MCP server provides a template registry that Claude can query, instantiate with user-provided parameters, and deploy to n8n. Supports parameterization of node configurations, credentials, and data mappings to adapt templates to specific use cases.

Provides real-time visibility into workflow execution status, logs, and performance metrics through MCP-exposed endpoints that Claude can query. The system polls or subscribes to n8n execution events, aggregates execution history, and surfaces errors, performance bottlenecks, and data flow information. Supports filtering and searching execution logs by workflow, time range, status, or error type.

Allows modification of existing workflows through conversational commands that update node configurations, add/remove nodes, and adjust data mappings. The system parses edit requests, validates changes against n8n's node schema, applies updates to the workflow definition, and deploys the modified workflow. Supports both structural changes (adding nodes) and configuration changes (updating credentials, parameters).

Manages secure storage and retrieval of API credentials, OAuth tokens, and authentication details required by workflow nodes. The system interfaces with n8n's credential store through MCP tools, allowing Claude to reference credentials by name without exposing secrets in conversation. Supports credential creation, updates, and validation without requiring manual n8n UI interaction.

Handles the complete workflow deployment lifecycle including validation, activation, and status tracking. The system takes a workflow definition (generated or edited), validates it against n8n's requirements, deploys it to the target instance, and activates it for execution. Supports rollback to previous versions and deployment scheduling.

Executes workflows with test data and validates outputs against expected results. The system runs workflows in test mode, captures execution results, and compares them against user-defined expectations or previous baseline executions. Supports parameterized testing with multiple input scenarios and performance profiling.

Provides semantic and keyword-based search across workflows in n8n instances, enabling users to find existing workflows by name, description, tags, or functional purpose. The system queries n8n's workflow metadata, filters results, and returns matching workflows with relevant details. Supports discovery of workflows that might be reused or adapted for new use cases.

Analyzes workflow execution failures and provides actionable remediation suggestions based on error types, logs, and execution context. The system identifies common error patterns (authentication failures, timeout errors, data format mismatches), correlates them with workflow configuration, and suggests specific fixes. Integrates with workflow editing to apply fixes conversationally.