Manages multiple n8n instances through their API, providing tools for workflow operations (list, search, create, update, delete, toggle, execute), execution monitoring, and instance management.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@N8N MCP Serverlist all workflows in my production instance"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
N8N MCP Server
Serveur MCP (Model Context Protocol) pour gérer plusieurs instances N8N depuis Claude, VSCode ou tout autre client MCP.
Fonctionnalités
11 outils MCP disponibles :
Outil | Description |
| Lister les instances N8N disponibles |
| Lister les workflows |
| Rechercher des workflows |
| Récupérer un workflow |
| Créer un workflow |
| Mettre à jour un workflow |
| Supprimer un workflow |
| Activer/désactiver un workflow |
| Exécuter un workflow |
| Lister les exécutions |
| Détails d'une exécution |
Modes de transport
Le serveur supporte deux modes de transport :
Mode | Usage | Variable |
SSE (défaut) | Déploiement sur Coolify/Docker |
|
stdio | Usage local (Claude Desktop) |
|
Installation
Prérequis
Node.js 18+
Une ou plusieurs instances N8N avec API activée
Installation locale
# Cloner le repository
git clone https://github.com/businessarchi/n8n-mcp-server.git
cd n8n-mcp-server
# Installer les dépendances
npm install
# Build
npm run buildConfiguration
Variables d'environnement
Option 1 : Configuration JSON (recommandé pour plusieurs instances)
N8N_INSTANCES='[{"name":"prod","url":"https://n8n.example.com","apiKey":"your-api-key"},{"name":"dev","url":"https://n8n-dev.example.com","apiKey":"your-api-key"}]'Option 2 : Configuration individuelle
# Instance 1
N8N_INSTANCE_1_NAME=prod
N8N_INSTANCE_1_URL=https://n8n.example.com
N8N_INSTANCE_1_API_KEY=your-api-key
# Instance 2
N8N_INSTANCE_2_NAME=dev
N8N_INSTANCE_2_URL=https://n8n-dev.example.com
N8N_INSTANCE_2_API_KEY=your-api-keyOption 3 : Instance unique
N8N_URL=https://n8n.example.com
N8N_API_KEY=your-api-key
N8N_INSTANCE_NAME=defaultGénérer une clé API N8N
Aller dans Settings → API dans votre instance N8N
Créer une nouvelle clé API
Copier la clé et l'utiliser dans la configuration
Utilisation
Avec Claude Desktop (mode stdio)
Ajouter dans ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) :
{
"mcpServers": {
"n8n": {
"command": "node",
"args": ["/chemin/vers/n8n-mcp-server/dist/index.js"],
"env": {
"MCP_TRANSPORT": "stdio",
"N8N_INSTANCES": "[{\"name\":\"prod\",\"url\":\"https://n8n.example.com\",\"apiKey\":\"xxx\"}]"
}
}
}
}Avec un client MCP SSE (mode réseau)
Une fois déployé sur Coolify, le serveur expose :
Endpoint | Description |
| Informations sur le serveur |
| Health check |
| Connexion SSE pour les clients MCP |
| Envoi de messages au serveur |
Configuration client MCP SSE :
{
"mcpServers": {
"n8n": {
"transport": "sse",
"url": "https://votre-serveur.coolify.io/sse"
}
}
}Déploiement sur Coolify
Configuration Coolify
Créer une nouvelle application dans Coolify
Source : GitHub → Sélectionner ce repository
Type de build : Dockerfile
Port exposé :
3000
Variables d'environnement Coolify
N8N_INSTANCES=[{"name":"prod","url":"https://n8n.example.com","apiKey":"xxx"}]Ou individuellement :
N8N_INSTANCE_1_NAME=prod
N8N_INSTANCE_1_URL=https://n8n.example.com
N8N_INSTANCE_1_API_KEY=your-api-keyHealth Check
Configurer le health check vers /health sur le port 3000.
Développement
# Mode développement avec rechargement automatique
npm run dev
# Build
npm run build
# Démarrer en production (SSE par défaut)
npm start
# Démarrer en mode stdio
MCP_TRANSPORT=stdio npm startArchitecture
src/
├── index.ts # Point d'entrée MCP Server (SSE + stdio)
├── config.ts # Gestion de la configuration
├── n8n-client.ts # Client API N8N
├── tools.ts # Définitions des 11 outils MCP
└── types.ts # Types TypeScriptLicence
MIT