@muid-io/n8n-mcp-proxy

Professional MCP (Model Context Protocol) client for connecting Claude Desktop to n8n documentation and workflow validation tools via the muid.io proxy server. Eliminates scary error messages that appear with basic implementations.

✨ Features

• No "Failed" Status: Professional error handling eliminates scary error messages
• 534+ n8n nodes with comprehensive documentation
• Workflow validation with detailed error detection and fixes
• Real-time documentation directly from n8n source code
• AI-friendly templates and automation examples
• Universal compatibility with any MCP-compatible LLM application

🚀 Quick Setup

1. Get Your Access Token

Visit https://n8n-mcp.muid.io/dashboard to register and get your personal access token.

2. Add to Claude Desktop

Add this configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["-y", "@muid-io/n8n-mcp-proxy@latest"],
      "env": {
        "N8N_MCP_TOKEN": "your-token-from-dashboard"
      }
    }
  }
}

3. Restart Claude Desktop

Restart Claude Desktop to activate the n8n tools.

🛠 Available Tools

Once connected, you'll have access to 20+ n8n tools including:

• list_nodes() - Browse all available n8n nodes
• search_nodes(query) - Find nodes by functionality
• get_node_documentation(nodeType) - Get detailed documentation
• validate_workflow(workflow) - Validate complete workflows with error detection
• list_ai_tools() - Show AI-compatible nodes (263 available)
• get_templates_for_task(task) - Find pre-built workflow templates
• validate_node_operation(nodeType, config) - Validate node configurations

💡 Example Usage

Ask Claude Desktop:

• "List available n8n nodes for webhooks"
• "Get documentation for the HTTP Request node"
• "Validate this n8n workflow JSON"
• "Find n8n templates for email automation"
• "Show me AI-compatible n8n nodes"

🔧 Advanced Configuration

Custom Server URL

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx", 
      "args": ["-y", "@muid-io/n8n-mcp-proxy@latest"],
      "env": {
        "N8N_MCP_TOKEN": "your-token",
        "N8N_MCP_URL": "https://custom-server.com/mcp"
      }
    }
  }
}

Manual Testing

# Test the package directly
N8N_MCP_TOKEN="your-token" npx @muid-io/n8n-mcp-proxy@latest

# Check version
npx @muid-io/n8n-mcp-proxy@latest --version

# Show help
npx @muid-io/n8n-mcp-proxy@latest --help

🔐 Authentication & Security

• Individual tokens: Each user gets their own access token
• Scope-limited access: Tokens are read-only for documentation and validation
• Secure transmission: All requests use HTTPS with proper authentication
• No data storage: Proxy forwards requests without storing any workflow data

📊 Server Statistics

• 525 total n8n nodes documented
• 263 AI-compatible tools available
• 104 trigger nodes for workflow automation
• 87% documentation coverage with examples and patterns
• Real-time updates from n8n source code

🌐 Universal Compatibility

This package works with any LLM application that supports MCP:

• Claude Desktop (primary target)
• Other MCP-compatible applications using the same configuration pattern

📖 Documentation & Support

• Server Dashboard: https://n8n-mcp.muid.io/dashboard
• Service Status: https://n8n-mcp.muid.io/
• Get Your Token: https://n8n-mcp.muid.io/dashboard
• GitHub Issues: Report problems or feature requests

🏗 Technical Details

• Protocol: MCP (Model Context Protocol) 2024-11-05 / 2025-06-18
• Transport: stdio (standard for Claude Desktop)
• Authentication: Bearer token system
• Error Handling: Professional-grade with no scary error messages
• Node.js: Requires Node.js 18.0.0 or higher

📝 License

MIT - See LICENSE file for details.

Made by muid.io - Professional n8n automation tools and services.