N8N MCP

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

Demo Coming Soon

Screenshot placeholder: Extension in action showing Copilot integration

Features

Complete N8N API Coverage

All public N8N API endpoints dynamically loaded from your instance's OpenAPI specification
Automatic tool generation - no manual endpoint configuration needed

Workflow Management

Create, read, update, and delete workflows
Activate/deactivate workflows on demand
Version control and workflow tagging

Execution Control

Execute workflows programmatically
Monitor execution history and status
Retry failed executions automatically

Credential Management

Securely create and manage N8N credentials
Retrieve credential schemas for any integration
Transfer credentials between projects

Natural Language Control

Full GitHub Copilot integration
Control N8N using plain English commands
Context-aware suggestions

Administration & Monitoring

User management (with admin permissions)
Audit log access
Tag organization and filtering

Screenshots

Note: Screenshots will be added in future updates.

Configuration: Simple setup dialog for API URL and key
Copilot Integration: Natural language commands in Copilot chat
Workflow Management: List, create, and control workflows through conversation

Quick Start

Installation

Option 1: From VS Code Marketplace (Recommended)

Open VS Code
Press Cmd+Shift+X (Mac) or Ctrl+Shift+X (Windows/Linux)
Search for "N8N MCP"
Click Install

Option 2: From VSIX File

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

Configuration

Step 1: Open Configuration

Press Cmd+Shift+P / Ctrl+Shift+P
Type "N8N MCP: Configure"
Press Enter

Step 2: Enter N8N API URL

Examples:
https://n8n.yourcompany.com/api/v1
http://localhost:5678/api/v1

Note: Always include http:// or https://

Step 3: Enter N8N API Key

Generate from: N8N → Settings → API → Create API Key
Paste the key when prompted
Your key is stored securely in VS Code settings

Step 4: Reload VS Code

Press Cmd+Shift+P / Ctrl+Shift+P
Type "Developer: Reload Window"

You're ready! The MCP server will automatically start and load all available N8N endpoints.

Usage Examples

Ask GitHub Copilot in chat:

"List all my N8N workflows"
"Show me failed executions from today"
"Create a workflow that sends daily email reports"
"Activate the workflow named 'Data Sync'"
"What credentials are configured in N8N?"

Example: List Active Workflows

You: "Show me all active N8N workflows"

Copilot:

Fetching active workflows...
Found 5 active workflows:
1. Daily Data Sync (ID: abc123)
2. Email Notifications (ID: def456)
3. Slack Alerts (ID: ghi789)
...

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).

Extension Settings

Configure N8N MCP via VS Code Settings (Cmd+, or Ctrl+,):

Setting	Type	Default	Description
`n8nMcp.apiUrl`	string	`""`	N8N API URL with protocol (e.g., `https://n8n.yourcompany.com/api/v1`)
`n8nMcp.apiKey`	string	`""`	N8N API Key (from Settings → API → Create API Key)
`n8nMcp.enabled`	boolean	`true`	Enable/disable the MCP server
`n8nMcp.debug`	boolean	`false`	Enable verbose logging for debugging

Security Note: API keys are stored securely in VS Code's encrypted settings storage.

Requirements

VS Code: 1.96.0 or higher
GitHub Copilot: Extension must be installed and active
N8N Instance: Running instance with API access enabled
N8N API Playground: Available at /api/v1/docs (enable in N8N Settings → API)

Known Issues

API Connection Issues

Problem: Extension can't connect to N8N instance
Solution: Verify URL format includes protocol (https://), check API key validity, ensure N8N API playground is enabled

Missing Endpoints

Problem: Some N8N features don't appear as tools
Solution: Extension loads endpoints from your N8N OpenAPI spec. If an endpoint is missing, it may not be documented in your N8N version's API specification.

Premium Features

Some N8N features require a premium license:

Variables management
Advanced project permissions
Source control integration
Role-based access control

See CHANGELOG.md for version-specific issues and fixes.

Troubleshooting

Enable Debug Mode (Recommended First Step)

If you're experiencing issues, enable debug mode for detailed logs:

Settings (Cmd+,) → Search "n8n mcp debug"
Enable "N8nMcp: Debug"
Reload VS Code (Cmd+Shift+P → "Developer: Reload Window")
Check logs: Output panel → Select "N8N MCP" from dropdown

Debug mode shows:

Arguments received from Copilot
Path parameter resolution steps
API request details
Validation errors and warnings

For detailed debugging guide, see docs/DEBUGGING.md

Extension Not Loading?

# Reload VS Code
Cmd+Shift+P → "Developer: Reload Window"

Commands Not Found?

Verify extension is installed and enabled
Check VS Code version (requires 1.96.0+)
Reinstall extension if needed

API Connection Fails?

# Test your N8N API manually
curl -H "X-N8N-API-KEY: your_key" https://n8n.yourcompany.com/api/v1/workflows

Common causes:

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
Network issues: Check firewall, VPN, SSL certificates

Development

Quick Dev Setup

# Install dependencies
npm install

# Build MCP server
npm run build-mcp

# Compile extension
npm run compile

# Watch mode (auto-recompile)
npm run watch

Debug Extension: Press F5 to launch Extension Development Host

Development Scripts: See scripts/README.md for testing and debugging utilities

Available Commands

Access via Command Palette (Cmd+Shift+P / Ctrl+Shift+P):

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 - View all available API endpoints from your N8N instance

Documentation

README.md - Main documentation (this file)
CHANGELOG.md - Version history and release notes
docs/DEBUGGING.md - Comprehensive debugging guide
SECURITY.md - Security policies and reporting

Release Notes

Version 1.3.0 (Current)

Features:

Complete N8N API coverage with dynamic endpoint loading
GitHub Copilot integration via Model Context Protocol
Workflow management (CRUD + activate/deactivate)
Execution control and monitoring
Credential management
User management (admin permissions)
Audit log access
Debug mode with comprehensive logging

Performance:

VSIX size optimized (lightweight distribution)
Cached OpenAPI spec (1 hour TTL)
Automatic retry on network errors (3 retries with exponential backoff)

Known Limitations:

Premium N8N features require license (Variables, Advanced Permissions, Source Control, Projects)
Workflow versioning requires manual version history

See CHANGELOG.md for complete version history.

Support & Contributing

Get Help

Email: support@norisix.com
Website: norisix.com
Documentation: docs/

Report Issues

Found a bug or have a feature request?

Email: support@norisix.com with details:
- Extension version
- VS Code version
- N8N instance version
- Steps to reproduce
- Debug logs (if applicable)

Security Issues

Do not publicly disclose security vulnerabilities.

Report security issues to: support@norisix.com

See SECURITY.md for our security policy.

License

See LICENSE file for details.

About Norisix

N8N MCP is developed and maintained by Norisix, a company specializing in automation and AI integration solutions.

Website: norisix.com

Enjoy using N8N MCP!

If you find this extension helpful, consider rating it on the VS Code Marketplace.