Complete n8n API integration for Claude Desktop and Cursor - Manage workflows, automate tasks, and control every aspect of n8n directly through AI conversations.

Transform your n8n workflow management with natural language commands. Create complex automations, monitor executions, manage credentials, and orchestrate your entire n8n infrastructure without leaving your IDE.

This server is optimized to minimize token consumption, addressing one of the biggest issues with MCP servers - excessive API token usage.

• 90% reduction in tokens for workflow listing with new n8n_list_workflows_summary endpoint
• Field filtering - request only the data you need
• Smart defaults - reduced from 100 to 10-20 results per query
• Intelligent warnings - alerts when operations will consume significant tokens

See TOKEN_OPTIMIZATION.md for detailed usage guide.

• Create & Deploy: Build workflows with natural language descriptions
• CRUD Operations: Full lifecycle management (Create, Read, Update, Delete)
• Activation Control: Enable/disable workflows on demand
• Project Transfer: Move workflows between projects seamlessly
• Tag Management: Organize workflows with custom tags

• Real-time Tracking: Monitor workflow executions with advanced filters
• Detailed Insights: Access full execution data and logs
• Error Recovery: Retry failed executions automatically
• Cleanup Tools: Manage execution history efficiently

• Secure Creation: Add credentials for any service
• Schema Discovery: Auto-discover required fields for credential types
• Project Isolation: Transfer credentials between projects safely
• Type Support: Compatible with all n8n credential types

• Pre-built Solutions: 100 production-ready workflow templates included
• Smart Matching: AI automatically selects the best template for your use case
• Categories: E-commerce, Social Media, AI/Chat, Communication, Content, HR, Sales/CRM, Finance, Data Scraping, Monitoring, Productivity
• Customizable: All templates are fully customizable starting points

• Tags: Categorize and organize resources
• Variables: Centralized environment variable management
• Projects: Multi-tenant project support
• Users & Permissions: Complete access control management
• Audit Logs: Generate security and compliance reports

This is the easiest way to get started:

npm install -g mcp-n8n

1. Get your n8n API credentials:

   • Navigate to your n8n instance → Settings → n8n API
   • Generate a new API key

2. Configure Claude Desktop:

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (Mac/Linux) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

Option A - Using global installation (if you ran npm install -g mcp-n8n):

{
  "mcpServers": {
    "n8n": {
      "command": "mcp-n8n",
      "env": {
        "N8N_BASE_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Option B - Using npx (no installation needed, always latest version):

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "mcp-n8n"],
      "env": {
        "N8N_BASE_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Configure Cursor:

Add to Cursor MCP settings (Settings → Extensions → MCP):

Recommended - Using npx (always uses latest version):

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "mcp-n8n"],
      "env": {
        "N8N_BASE_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Note: Cursor requires using npx for MCP servers. The -y flag automatically installs/updates the package without prompting.

4. Restart Claude Desktop or Cursor

Once configured, interact with n8n using natural language:

"Create a workflow that monitors my Gmail inbox and sends
Slack notifications for important emails"

"Build a daily report workflow that pulls data from my database,
generates charts, and emails them to my team"

"I need a WhatsApp chatbot with AI for customer support"
→ Automatically creates workflow from "WhatsApp AI Response Bot" template

"Create an automated stock analysis workflow"
→ Uses "Automated Stock Analysis with GPT-4" template

"Show me all active workflows in the production project"
→ Uses n8n_list_workflows_summary for efficient token usage

"Show me the details of workflow abc123"
→ Uses n8n_get_workflow to fetch complete details only when needed

"Deactivate the 'Daily Backup' workflow"

"What went wrong with execution abc123?"

"Show me the last 10 failed executions"

"Retry all failed executions from workflow xyz456"

"Delete all successful executions older than 30 days"

Total: 41 tools for complete n8n management

• Quick Start Guide - Get up and running in 5 minutes
• Examples & Use Cases - Real-world automation examples
• Node Reference - Detailed tool documentation
• Changelog - Version history and updates

mcp-n8n/
├── src/
│   ├── index.ts          # MCP server implementation
│   ├── n8n-client.ts     # n8n API client
│   └── types.ts          # TypeScript definitions
├── examples/
│   ├── templates-metadata.json
│   └── *.json            # Pre-built workflow templates
├── dist/                 # Compiled output
├── QUICKSTART.md         # Quick start guide
├── EXAMPLES.md           # Usage examples
├── NODE_REFERENCE.md     # API documentation
└── package.json

If you want to contribute or test local changes:

# Clone repository
git clone https://github.com/gomakers-ai/mcp-n8n.git
cd mcp-n8n

# Install dependencies
npm install

# Build
npm run build

# Development with auto-rebuild
npm run watch

For Claude Desktop, add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-n8n/dist/index.js"],
      "env": {
        "N8N_BASE_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

For Cursor, add to MCP settings:

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-n8n/dist/index.js"],
      "env": {
        "N8N_BASE_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Important: Replace /absolute/path/to/mcp-n8n/ with the actual absolute path to your cloned repository (e.g., /Users/yourname/projects/mcp-n8n/).

# Set environment variables
cp .env.example .env
# Edit .env with your credentials

# Build and test
npm run build
node dist/index.js

• Node.js: 18 or higher
• n8n Instance: Self-hosted or n8n Cloud (paid plan)
• n8n API Key: Required for authentication
• AI IDE: Claude Desktop or Cursor with MCP support

• Self-hosted: Full API access ✅
• n8n Cloud: Requires paid plan for API access
• Version: Compatible with n8n v1.0.0+

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• n8n - The workflow automation platform
• Anthropic - Claude and Model Context Protocol
• Cursor - AI-powered code editor

• n8n API Documentation
• Model Context Protocol
• n8n Community
• MCP Servers Registry

• n8n Cloud requires a paid plan to access the API
• Self-hosted n8n has full API access on all plans
• Some operations require owner/admin permissions

• Never commit .env files with credentials
• Use environment variables for sensitive data
• API keys grant full access to your n8n instance
• Regularly rotate API keys for security

• Respect n8n API rate limits
• Use pagination for large result sets
• Implement error handling for rate limit responses

Problem: "Cannot connect to n8n API"

• Verify N8N_BASE_URL is correct and accessible
• Check that API key is valid
• Ensure n8n instance is running

Problem: "Insufficient permissions"

• Some operations require owner/admin role
• Verify your user has appropriate permissions
• Check project-level access rights

Problem: "Template not found"

• Ensure examples/ directory is present
• Verify templates-metadata.json exists
• Check template file references are correct

1. Start with Templates: Use pre-built templates as starting points
2. Use Tags: Organize workflows with tags for easy management
3. Monitor Executions: Regularly check failed executions
4. Clean Up: Remove old execution data to save space
5. Version Control: Use n8n's built-in version control features
6. Test First: Test workflows before activating in production

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• n8n Community: community.n8n.io