zach0028/n8n-claude-MCP-server

n8n Claude MCP Server 🚀

Serveur MCP pour l'Intégration n8n avec Claude Desktop

🎯 Vue d'Ensemble

Ce serveur MCP offre à Claude Desktop des capacités de gestion de workflows n8n, incluant :

• 📚 Documentation de 30+ nœuds avec tous les paramètres
• 🔧 Manipulation granulaire au niveau de chaque paramètre
• 💡 100+ exemples d'expressions n8n
• 📝 30+ snippets de code réutilisables
• ✅ Validation complète à chaque étape
• 🎨 Aide contextuelle automatique

🔥 Capacités Claude

Claude peut maintenant :

• 🚀 Manipuler 90% des nœuds n8n (Slack, Gmail, OpenAI, Discord, etc.)
• 🔍 Consulter tous les paramètres de n'importe quel nœud
• 🎯 Modifier un seul paramètre sans recréer le workflow
• ✨ Utiliser toutes les expressions n8n ($json, $node, $now, etc.)
• 💻 Écrire du code JavaScript pour Function/Code nodes
• 🔐 Configurer les credentials et l'authentification
• 📖 Accéder à des snippets pré-faits pour cas courants
• 🔄 Découverte automatique des nœuds non documentés

Features

Core Workflow Management

• Complete CRUD operations with progressive API fallback handling
• Intelligent workflow validation with error detection and suggestions
• Enterprise security features including JWT authentication and RBAC
• Progressive error handling with 5-tier fallback strategy

Advanced Analysis & Visualization

• Structure analysis with complexity metrics and performance insights
• Security auditing with credential usage and vulnerability detection
• Visual workflow diagrams in ASCII and Mermaid formats
• Performance optimization suggestions based on best practices

Granular Modification Tools

• Surgical node modification without workflow recreation
• Smart node addition with automatic connection inference
• Intelligent connection management with validation and cleanup
• Bulk workflow operations with safety checks

Templating & Versioning

• Template creation from existing workflows with parameterization
• Workflow comparison with detailed diff analysis
• Rollback capabilities with automatic backup creation
• Template marketplace with categorization and search

Installation

Prerequisites

• Node.js 20+ installed
• n8n running on http://localhost:5678
• Valid n8n API key configured
• Claude Desktop installed

Setup Instructions

1. Clone and install dependencies

git clone https://github.com/YOUR_USERNAME/n8n-claude-mcp-server.git
cd n8n-claude-mcp-server
npm install

2. Configure Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": ["/path/to/n8n-claude-mcp-server/index-minimal.js"],
      "env": {
        "N8N_API_URL": "http://localhost:5678",
        "N8N_API_KEY": "your_n8n_api_key_here"
      }
    }
  }
}

3. Restart Claude Desktop to activate the MCP server

Available Tools

Workflow Management

Granular Modification Tools

Advanced Analysis

Templating & Versioning

Execution Management

Utility Tools

Usage Examples

Basic Workflow Operations

"Create a webhook to email workflow in n8n with proper error handling"

"Analyze the structure and performance of workflow ID 123 and suggest improvements"

Granular Modifications

"Modify the HTTP Request node in workflow 456 to change the URL to https://api.example.com"

"Add a data transformation node between the webhook and email nodes in my workflow"

Analysis & Optimization

"Generate a visual diagram of workflow 789 showing all connections"

"Compare workflows 123 and 456 to see what changed between versions"

Templating & Reusability

"Create a template from workflow 321 that allows customizable email addresses and API endpoints"

"Apply the 'webhook-to-slack' template to create a new workflow with custom parameters"

Technical Architecture

API Compatibility

• Official n8n REST API endpoints (/rest/workflows)
• Standard HTTP methods (GET, POST, PUT, DELETE)
• Authentication via X-N8N-API-KEY header
• Progressive fallback strategy for maximum compatibility

Data Validation

• Comprehensive sanitization for n8n API compliance
• Node parameter validation with type-specific rules
• Connection integrity checking with automatic fixes
• Schema validation using AJV with format extensions

Error Handling

• 5-tier progressive retry strategy with intelligent fallback
• Contextual error messages with actionable solutions
• Automatic parameter correction for common issues
• Debug information for troubleshooting

Security Features

• JWT authentication with configurable expiration
• Role-based access control (RBAC) with permissions
• Audit logging for compliance tracking
• Multi-tenant support with isolated environments

Configuration

Environment Variables

N8N_API_URL=http://localhost:5678
N8N_API_KEY=your_api_key_here

# Optional Enterprise Features
JWT_SECRET=your_jwt_secret
ENABLE_RBAC=true
ENABLE_AUDIT_LOG=true
ENABLE_MULTI_TENANT=false

n8n API Key Setup

1. Access n8n Settings → API Keys
2. Generate new API key
3. Configure in environment variables

Advanced Features

Workflow Analysis Engine

• Complexity metrics calculation with industry standards
• Performance bottleneck detection and optimization
• Security vulnerability scanning and recommendations
• Best practices validation based on community patterns

Intelligent Templating

• Parameter extraction for customizable workflows
• Category-based organization with search capabilities
• Version control with diff tracking and rollback
• Marketplace integration for template sharing

Enterprise Integration

• Multi-environment support for development workflows
• Batch operations for large-scale workflow management
• Backup and recovery with automated scheduling
• Monitoring and alerting for workflow health

Contributing

We welcome contributions! Please follow these guidelines:

1. Fork the repository and create a feature branch
2. Follow existing code style and documentation standards
3. Add tests for new functionality
4. Update documentation for any changes
5. Submit a pull request with clear description

License

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

Acknowledgments

• Anthropic for Claude and the MCP protocol
• n8n.io for the powerful automation platform
• Open source community for n8n integration patterns and best practices

Resources

• n8n Documentation
• Model Context Protocol Specification
• n8n API Reference
• Claude Desktop

Professional n8n integration for Claude Desktop - No limitations, complete control