n8n MCP Workflow Builder¶

AI-powered n8n workflow management via Model Context Protocol

What is n8n MCP Workflow Builder?¶

The n8n MCP Workflow Builder is a powerful MCP (Model Context Protocol) server that enables AI assistants like Claude and Cursor IDE to create, manage, and monitor n8n workflows through natural language interactions. It acts as a bridge between AI interfaces and your n8n automation platform.

Key Features¶

Multi-Instance Support¶

Manage multiple n8n environments (production, staging, development) from a single MCP server with intelligent instance routing.

Natural Language Workflows¶

Create and manage workflows through conversational AI - no manual JSON editing required.

17 MCP Tools¶

Comprehensive toolset for workflows, executions, tags, and credentials management.

Quick Integration¶

Seamless integration with Claude Desktop and Cursor IDE via MCP protocol.

Secure by Default¶

Built-in credential protection, API key encryption, and secure multi-instance configuration.

Real-time Monitoring¶

Track workflow executions, monitor performance, and debug issues with execution statistics.

Quick Start¶

Installation¶

# Install globally
npm install -g @kernel.salacoste/n8n-workflow-builder

# Verify installation
npx @kernel.salacoste/n8n-workflow-builder --version

# Run directly without installation
npx @kernel.salacoste/n8n-workflow-builder

# Clone repository
git clone https://github.com/salacoste/mcp-n8n-workflow-builder.git
cd mcp-n8n-workflow-builder

# Install dependencies
npm install

# Build project
npm run build

Configuration¶

Create .config.json for multi-instance setup:

{
  "environments": {
    "production": {
      "n8n_host": "https://n8n.example.com",
      "n8n_api_key": "your_production_api_key"
    },
    "development": {
      "n8n_host": "http://localhost:5678",
      "n8n_api_key": "your_development_api_key"
    }
  },
  "defaultEnv": "development"
}

Full Configuration Guide

Claude Desktop Integration¶

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": ["@kernel.salacoste/n8n-workflow-builder"]
    }
  }
}

Detailed Integration Guide

Use Cases¶

Scheduled Automation¶

Create workflows with cron triggers for periodic tasks like data backups, report generation, and system monitoring.

API Integration¶

Connect external services and APIs with natural language instructions - no manual node configuration needed.

Data Processing¶

Build data transformation pipelines that extract, transform, and load data between systems.

Webhook Receivers¶

Set up HTTP endpoints that respond to external events and trigger automated workflows.

AI-Powered Workflows¶

Leverage Claude AI to intelligently generate workflow logic based on your business requirements.

What's New in v0.9.1¶

Latest Updates:

• ✅ Full MCP notification handler support
• ✅ Fixed "Method 'notifications/initialized' not found" error
• ✅ Package size optimization (1.3MB → 278KB)
• ✅ Multi-instance architecture with intelligent routing
• ✅ Enhanced credential management with schema validation
• ✅ Comprehensive documentation site with 38+ pages

View Full Changelog

System Requirements¶

Community & Support¶

License¶

This project is licensed under the MIT License. See LICENSE for details.

Next Steps¶

Ready to get started? Follow our installation guide:

Install n8n MCP Workflow Builder