npm package: @muid-io/n8n-mcp-proxy
Description: CORRECT NPX CONFIG: Shows proper NPX configuration in auth error messages for easy setup.
Author: muid.io
Latest version: 1.2.7

# @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`:

```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
```json
{
  "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
```bash
# 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.