Skip to main content
Connect n8n-MCP to Cursor IDE for enhanced n8n workflow development with AI assistance.

Video Tutorial

Watch the complete setup process

​
Prerequisites

  • Cursor IDE installed
  • Node.js installed on your system
  • n8n instance (optional, for full workflow management)

​
Installation

1

Create MCP Configuration Directory

Create a .cursor folder in your project root:
mkdir .cursor
2

Create MCP Configuration File

Create mcp.json file inside the .cursor folder with your configuration:
Documentation tools only - No n8n API connection required.
.cursor/mcp.json
{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true"
      }
    }
  }
}
3

Enable MCP Server in Cursor

  1. Click the “Enable MCP Server” button in Cursor when prompted
  2. Go to Cursor Settings
  3. Search for “mcp”
  4. Confirm MCP is working and n8n-mcp appears in the list
4

Set Up Project Instructions

Configure Cursor with n8n-specific instructions:
  1. In your Cursor chat, invoke “create rule” and hit Tab
  2. Name the rule (e.g., “n8n-mcp”)
  3. Set rule type to “always”
  4. Copy the Claude Project instructions from the Claude Project Setup section

​
Configuration Options

​
Environment Variables

​
MCP_MODE
string
default:"stdio"
required
Mode for MCP communication. Use “stdio” for Cursor.
​
LOG_LEVEL
string
default:"info"
Logging level. Set to “error” to reduce noise.
​
DISABLE_CONSOLE_OUTPUT
string
default:"false"
Set to “true” to disable console output.
​
N8N_API_URL
string
Your n8n instance URL (e.g., https://your-n8n-instance.com or http://localhost:5678)
​
N8N_API_KEY
string
Your n8n API key for workflow management operations

​
Verification

To verify your setup is working:
1

Open Cursor Chat

Open the Cursor AI chat panel.
2

Check MCP Status

Look for the MCP indicator showing n8n-mcp is connected.
3

Test a Command

Try a simple prompt:
Search for Slack integration nodes in n8n
4

Verify Tools Available

You should see n8n-mcp tools being used in the response. With API credentials, you’ll have access to all workflow management tools.

​
Usage Examples

​
Building a Workflow

Create an n8n workflow that:
1. Triggers on a webhook
2. Processes the incoming data
3. Sends a Slack notification

​
Validating Configurations

Validate this n8n Slack node configuration:
{
  "resource": "message",
  "operation": "post",
  "text": "Hello World"
}

​
Searching Documentation

How do I configure authentication for the Google Sheets node?

​
Tips

  • Use Cursor’s composer mode for building complete workflows
  • Always validate node configurations before deploying
  • Use the “always” rule type for project instructions to ensure they’re applied consistently
  • Leverage Cursor’s multi-file editing for complex workflow projects

​
Troubleshooting

  1. Verify the .cursor/mcp.json file is in your project root
  2. Check the JSON syntax is valid
  3. Restart Cursor IDE
  4. Click “Enable MCP Server” if prompted
  • Ensure Node.js is installed: node --version
  • Verify npm is in your PATH
  • Try using the full path to npx in the configuration
  • Verify your n8n instance is running
  • Check the N8N_API_URL is correct and accessible
  • Verify your N8N_API_KEY is valid
  • Check firewall settings if using a remote instance
  • Verify project instructions are set up correctly
  • Try removing and re-adding the MCP server
  • Check Cursor’s MCP settings are enabled
  • Review the Cursor console for error messages

​
Next Steps

Claude Project Setup

Configure optimal project instructions

Available Tools

Explore all n8n-MCP tools

Building Workflows

Learn workflow best practices

Video Tutorial

Watch the setup walkthrough

Build docs developers (and LLMs) love

Get started for freeTalk to us