N8N2MCP

v1.0.0Business Applicationsstable

Convert N8N agent / workflow into MCP servers, you can use it in Claude / Cursor / Super Chain

mcpmcp-servern8nn8n-workflow
Share:
129
Stars
0
Downloads
0
Weekly
0/5

What is N8N2MCP?

N8N2MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to convert n8n agent / workflow into mcp servers, you can use it in claude / cursor / super chain

Convert N8N agent / workflow into MCP servers, you can use it in Claude / Cursor / Super Chain

This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Convert N8N agent / workflow into MCP servers, you can use i

Use Cases

Convert N8N workflows into MCP servers for AI integration.
Expose N8N automation capabilities to Claude and Cursor.
Super-Chain

Maintainer

LicenseMIT
Languagehtml
Versionv1.0.0
UpdatedApr 28, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx n8n2mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use N8N2MCP

N8N2MCP is a bridge that converts your existing n8n workflows and agents into fully callable MCP (Model Context Protocol) servers, making them accessible from AI assistants like Claude, Cursor, and other MCP-compatible clients. Instead of rebuilding automation logic, you point N8N2MCP at your n8n instance and it dynamically exposes each workflow as an AI-callable function. This lets you reuse hundreds of pre-built n8n integrations—email, CRMs, databases, webhooks—as tools for your AI agent.

Prerequisites

  • Docker and Docker Compose installed (recommended) or Python 3.9+ for manual setup
  • A running n8n instance with workflows you want to expose
  • n8n API key and base URL for your n8n instance
  • A Supabase project (URL, anon key, and service role key)
  • An MCP-compatible client such as Claude Desktop or Cursor
1

Clone the N8N2MCP repository

Clone the repository from GitHub to get the Docker Compose setup and configuration files.

git clone https://github.com/Super-Chain/N8N2MCP.git
cd N8N2MCP
2

Configure environment variables

Copy the example env file and fill in your credentials for Supabase, n8n, and the MCP router.

cp env.example .env
3

Set required variables in .env

Configure the required credentials. N8N_BASE_URL must use https://, and N8N_BUILDER_URL must use http://. FLASK_HOST/PORT control the marketplace server and MCP_HOST/PORT control the MCP router.

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_KEY=your_anon_key
SUPABASE_SERVICE_KEY=your_service_role_key
X_N8N_API_KEY=your_n8n_api_key
N8N_BASE_URL=https://your-n8n-instance.com
N8N_USERNAME=your_username
N8N_PASSWORD=your_password
N8N_BUILDER_URL=http://localhost:6545
FLASK_HOST=0.0.0.0
FLASK_PORT=5000
MCP_HOST=0.0.0.0
MCP_PORT=6545
4

Start with Docker Compose

Launch all services with Docker Compose. This starts the marketplace server and MCP router.

docker-compose up -d
5

Verify the MCP router is running

Test that the MCP router is running and can list available workflow endpoints.

curl http://localhost:6545/list
6

Configure your MCP client

Add the N8N2MCP server to your MCP client using the generated endpoint URL. Each workflow is accessible at /mcp/{workflow_id}/{api_key}.

N8N2MCP Examples

Client configuration

Add the N8N2MCP server to your claude_desktop_config.json. The server exposes workflows via HTTP, so you connect to the running router endpoint.

{
  "mcpServers": {
    "n8n2mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:6545/mcp/{workflow_id}/{api_key}"]
    }
  }
}

Prompts to try

Once your n8n workflows are connected as MCP tools, use these prompts with Claude to trigger automation.

- "Run my 'Send Welcome Email' workflow for new user [email protected]"
- "Trigger the CRM sync workflow to pull latest contacts from HubSpot"
- "Execute the Slack notification workflow with message: 'Deploy complete'"
- "List all available n8n workflows I can run"
- "Run the data export workflow and tell me how many records were processed"

Troubleshooting N8N2MCP

Docker Compose starts but /list returns empty or connection refused

Check that N8N_BASE_URL is accessible from inside Docker and uses https://. Verify N8N_BUILDER_URL uses http:// (not https://). Run 'docker-compose logs mcp-router' to see connection errors.

Supabase authentication errors on startup

Make sure SUPABASE_SERVICE_KEY is the service role key (not the anon key) for admin operations. The anon key goes in SUPABASE_KEY. Both are found in your Supabase project Settings > API.

n8n workflows not appearing as MCP tools

The n8n API key (X_N8N_API_KEY) must have permission to list and execute workflows. Generate a new API key in n8n under Settings > n8n API and ensure your workflows are active (not draft).

Frequently Asked Questions about N8N2MCP

What is N8N2MCP?

N8N2MCP is a Model Context Protocol (MCP) server that convert n8n agent / workflow into mcp servers, you can use it in claude / cursor / super chain It connects AI assistants to external tools and data sources through a standardized interface.

How do I install N8N2MCP?

Follow the installation instructions on the N8N2MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with N8N2MCP?

N8N2MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is N8N2MCP free to use?

Yes, N8N2MCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

N8N2MCP Alternatives — Similar Business Applications Servers

Looking for alternatives to N8N2MCP? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.

n8n

189.1k

A comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou

LobeHub

77.5k

🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.

Jeecgboot

46.4k

AI 低代码平台,「低代码 + 零代码」双模式驱动:低代码一键生成前后端代码,零代码 5 分钟搭建系统,AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等,兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式,消除 Java 项目 80% 的重复工作,提效而不失灵活。

CowAgent

44.7k

CowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理,能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长,比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入,可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI,能处理文本、语音、图片和文件,可快速搭建个人AI助理和企业数字员工。

Minds Platform

39.2k

Platform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.

Astrbot

32.8k

AI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨

Browse More Business Applications MCP Servers

Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "n8n2mcp": { "command": "npx", "args": ["-y", "n8n2mcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use N8N2MCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides