N8N MCP Server
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
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Appeared in Searches
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/businessarchi/n8n-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server