Cursor Setup

Connect Cursor IDE to n8n MCP Bridge for AI-powered workflow automation in your editor.

Prerequisites

• Cursor IDE installed (download here)
• n8n MCP Bridge running
• MCP API key created

Configuration

Step 1: Open Cursor Settings

1. Open Cursor
2. Press Cmd/Ctrl+,
3. Search for "MCP" or "Model Context"

Step 2: Add MCP Server

Add this to your Cursor settings:

{
  "mcp.servers": {
    "n8n": {
      "url": "http://localhost:3001/mcp?apiKey=mcp_your_key_here"
    }
  }
}

Step 3: Restart Cursor

1. Quit Cursor completely
2. Restart Cursor
3. MCP server should load

Verification

Test in Cursor's AI chat:

@n8n Can you ping my n8n instance?

Expected response:

✓ n8n connection successful

Usage

In Chat

Use Cursor's AI chat with n8n context:

@n8n Execute my welcome email workflow

In Composer

Reference n8n in Cursor Composer:

Create a function that triggers my n8n payment workflow
Use @n8n to get workflow details

Configuration Options

Custom Name

{
  "mcp.servers": {
    "my-n8n-server": {
      "url": "http://localhost:3001/mcp?apiKey=mcp_key",
      "name": "Production n8n"
    }
  }
}

Multiple Instances

{
  "mcp.servers": {
    "n8n-prod": {
      "url": "https://mcp.example.com/mcp?apiKey=mcp_prod"
    },
    "n8n-dev": {
      "url": "http://localhost:3001/mcp?apiKey=mcp_dev"
    }
  }
}

Project-Specific Config

Create .cursor/settings.json in your project:

{
  "mcp.servers": {
    "project-n8n": {
      "url": "http://localhost:3001/mcp?apiKey=mcp_project_key"
    }
  }
}

Troubleshooting

Server Not Loading

1. Check JSON syntax in settings
2. Verify API key format
3. Restart Cursor
4. Check Cursor's developer console for errors

Connection Failed

1. Test MCP server: curl http://localhost:3001/health
2. Verify API key in dashboard
3. Check firewall settings
4. Review Cursor logs

Next Steps

• Learn About OAuth Flow →
• View Troubleshooting Guide →
• Explore MCP Tools →