N8N MCP Extension

Model Context Protocol integration for N8N - Control your N8N workflows with GitHub Copilot directly in VS Code.

Features

✨ All Public N8N API Endpoints - Dynamically loaded from your instance OpenAPI docs
🔧 Workflow Management - Create, update, activate workflows
⚡ Execution Control - Run and monitor workflow executions
🔐 Credential Management - Securely manage N8N credentials
🤖 GitHub Copilot Integration - Natural language control
📊 Statistics & Audit - Access logs and analytics

Quick Start

Installation

From VS Code Marketplace:

Open VS Code
Go to Extensions (Cmd+Shift+X / Ctrl+Shift+X)
Search for "N8N MCP"
Click Install

From VSIX:

Download the .vsix file
Open VS Code
Press Cmd+Shift+P / Ctrl+Shift+P
Type "Extensions: Install from VSIX"
Select the downloaded file

Configuration

Press Cmd+Shift+P / Ctrl+Shift+P
Type "N8N MCP: Configure"
Enter your N8N API URL (with protocol):
- Local instance: http://localhost:5678/api/v1
- Remote instance: https://n8n.yourcompany.com/api/v1
- Custom domain: https://n8n.norisix.com/api/v1
Enter your N8N API Key (from N8N Settings → API)
Reload VS Code
Run "N8N MCP: Start Server" if it is disabled

💡 Important: Always include http:// or https:// in your URL

Usage

Ask GitHub Copilot in chat or inline:

"List all my N8N workflows"
"Create a workflow that sends daily emails"
"Show failed executions from today"
"Debug workflow ID abc123"
"Activate workflow xyz and run it"

Available Commands

N8N MCP: Configure - Set up API credentials
N8N MCP: Start Server - Enable the MCP server
N8N MCP: Stop Server - Disable the MCP server
N8N MCP: List Endpoints - Display all available API endpoints from your instance

Supported Features (Clear Statement)

This extension exposes all public endpoints available in your N8N instance by loading the OpenAPI spec from: {n8nApiUrl}/docs (the N8N API playground).
If an endpoint exists in that spec, it is available as an MCP tool. Tool inputs use a consistent shape: { path, query, body } (only the parts needed by the endpoint).

Settings

Setting	Description	Example
`n8nMcp.apiUrl`	N8N API URL (with protocol)	`https://n8n.yourcompany.com/api/v1` or `http://localhost:5678/api/v1`
`n8nMcp.apiKey`	N8N API Key	`n8n_api_...`
`n8nMcp.enabled`	Enable/disable MCP server	`true`

Requirements

VS Code 1.96.0 or higher
N8N instance with API access enabled
N8N API playground available at /api/v1/docs
GitHub Copilot extension installed

Troubleshooting

Extension not loading?

Cmd+Shift+P → "Developer: Reload Window"

Command not found?

Reinstall the extension or check VS Code version (1.96+ required)

API connection fails?

# Test your N8N API (replace with your URL)
curl -H "X-N8N-API-KEY: your_key" https://n8n.yourcompany.com/api/v1/workflows
# Or for localhost:
curl -H "X-N8N-API-KEY: your_key" http://localhost:5678/api/v1/workflows

Common issues:

❌ Missing protocol: Use https://n8n.com/api/v1 not n8n.com/api/v1
❌ Wrong path: URL must end with /api/v1
❌ API disabled: Enable in N8N Settings → API
❌ Invalid key: Generate new key in N8N Settings → API
❌ CORS/SSL: For self-signed certs, check browser console

Development

git clone https://gitlab.ent.norisix.com/utils/saas/n8n-mcp.git
cd n8n-mcp
npm install
npm run build-mcp
npm run watch

Press F5 to launch Extension Development Host.

Support

License

Developed by Norisix