Intégration MongoDB n8nAutomatiser MongoDB avec n8n.
Tes workflows produisent des données qu'il faut bien poser quelque part. L'intégration MongoDB n8n donne accès à 11 opérations réparties sur 2 ressources : lecture, insertion, mise à jour, remplacement, suppression et pipeline d'agrégation côté documents, gestion des index de recherche côté index.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
À quoi sert l'intégration MongoDB n8n ?
Le nœud MongoDB relie un workflow n8n à une base MongoDB et y exécute des requêtes. Les 11 opérations se rangent sous 2 ressources : Document, pour tout ce qui se lit et s'écrit dans une collection, et Search Index, pour les index qui rendent cette collection cherchable. Les filtres s'écrivent en JSON, exactement comme on les passerait à la base, sans formulaire simplifié entre les deux.
Premier usage, et de loin le plus courant : la collection sert de point de chute. Un workflow de collecte parcourt une liste de pages, un nœud HTTP Request en ramène le contenu, et document.insert écrit un document par page. Quand la même donnée part aussi vers Google Sheets, le réflexe utile est de garder la feuille pour ce qu'on relit à l'œil et la collection pour le volume.
Deuxième usage, la lecture. Un Schedule Trigger réveille le workflow, document.find remonte les documents qui matchent la requête, et la suite les met en forme, par exemple dans un message Slack. Si le besoin se résume à un total ou à un décompte, document.aggregate fait le calcul dans la base et ne renvoie que le résultat. L'exécution reste légère, même sur une grosse collection.
Troisième usage, la synchronisation. Un événement arrive avec un identifiant, document.findOneAndUpdate écrit les nouvelles valeurs sur le document correspondant, et Upsert le crée quand rien ne correspond. La logique ressemble à celle des nœuds Postgres ou MySQL, à ceci près qu'un champ nouveau n'impose pas de migration.
Deux limites à connaître avant de câbler quoi que ce soit. MongoDB n'a pas de nœud trigger dans n8n : rien ne réagit tout seul à l'écriture d'un document. C'est un Schedule Trigger à intervalle fixe, ou un Webhook n8n appelé par l'application qui écrit, qui ouvre le workflow. Et les filtres sont écrits à la main : un opérateur mal orthographié renvoie une liste vide, pas une erreur. Teste toujours la requête dans Find documents avant de la brancher sur Delete documents.
Le nœud HTTP Request est-il un recours ici ? D'habitude oui : il appelle un endpoint que le nœud dédié laisse de côté, en réutilisant le même credential. Sauf que le credential MongoDB ouvre une chaîne de connexion à la base, pas une clé d'API : aucun endpoint HTTP n'existe à appeler avec. Le vrai recours, ce sont Find documents et Aggregate documents, qui acceptent une requête ou un pipeline JSON écrits à la main. Tout ce qui sort de ces 11 opérations passe par l'un des deux. Le choix entre instance auto-hébergée et offre hébergée, lui, se discute dans l'Avis n8n, et la prise en main complète du produit dans la Formation n8n.
De quoi n8n a-t-il besoin pour joindre ta base ?
- 01
Créer un utilisateur de base dédié
Un workflow se connecte à MongoDB avec un utilisateur de base de données, jamais avec ton compte de console. Crée-le sur le serveur avec les droits strictement nécessaires : lecture seule si la branche s'arrête à Find documents, lecture et écriture dès que Insert documents, Update documents ou Delete documents entrent en jeu. Garde le nom d'utilisateur et le mot de passe sous la main, les deux servent juste après.
- 02
Ouvrir le réseau à n8n
Un cluster ne répond qu'aux adresses qu'il connaît. En tant que Project Owner, ouvre Network Access dans le projet et ajoute les adresses IP de n8n aux IP Access List Entries. Sans cette étape, la connexion n'arrive même pas jusqu'à la requête : le nœud est bloqué avant d'avoir posé sa question à la base.
- 03
Renseigner le credential MongoDB
Dans le menu Credentials, crée un credential MongoDB, la fiche de connexion que n8n mémorise et réutilise. Choisis d'abord un Configuration Type. Connection String attend la chaîne lue sous Database, Connect, Drivers, du type
mongodb+srv://user:password@cluster.mongodb.net/, avec le vrai utilisateur et le vrai mot de passe, plus le nom de la Database. Values demande les mêmes éléments un par un : Host, Database, User, Password et Port.
Ce que le nœud MongoDB sait faire, opération par opération
Le nœud MongoDB expose 11 opérations sur 2 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
| Ressource | Update | Delete | Aggregate | Create | Drop | Find | Find And Replace | Find And Update | Insert | List | Update |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Search Index | ✓ | ✓ | ✓ | ✓ | |||||||
| Document | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Sommaire des opérations
Search Index
4 opérationsCreate Search Index
searchIndexes.createSearchIndexCe que tu vois dans n8n
Notes & cas d'usage
Crée un index de recherche sur une collection. Son contenu devient cherchable, et la forme de cet index tient dans une définition JSON plutôt que dans un formulaire déjà tout fait.
Paramètres clés
- Collection : la collection sur laquelle l'index est construit, orthographiée comme dans la base.
- Index Name : le nom de l'index, qui servira de poignée à toutes les opérations suivantes.
- Index Type : deux valeurs seulement,
vectorSearchousearch. - Index Definition : la définition en JSON, sur le modèle affiché dans le champ,
{ "type": "vectorSearch", "definition": {} }.
Drop Search Index
searchIndexes.dropSearchIndexCe que tu vois dans n8n
Notes & cas d'usage
Supprime un index de recherche. Les documents de la collection restent en place, seul l'index disparaît, et deux noms suffisent à l'opération.
Paramètres clés
- Collection : la collection à laquelle l'index appartient aujourd'hui.
- Index Name : le nom exact donné à la création, puisque l'opération ne propose aucune liste de choix.
List Search Indexes
searchIndexes.listSearchIndexesCe que tu vois dans n8n
Notes & cas d'usage
Renvoie les index de recherche définis sur une collection. C'est la seule opération en lecture de la ressource, et celle qu'on appelle quand le workflow doit décider de la suite.
Paramètres clés
- Collection : la collection dont on liste les index.
- Index Name : facultatif, mais il change la nature de l'appel. Rempli, seuls les index portant ce nom remontent, ce qui transforme l'opération en test d'existence.
Update Search Index
searchIndexes.updateSearchIndexCe que tu vois dans n8n
Notes & cas d'usage
Envoie une nouvelle définition à un index qui existe déjà. Regarde ce qui manque par rapport à la création : pas de Index Type ici, le type reste celui choisi au départ.
Paramètres clés
- Collection : la collection qui héberge l'index.
- Index Name : l'index qui reçoit la nouvelle définition.
- Index Definition : la définition complète en JSON, au même format qu'à la création, placeholder compris dans le champ.
Document
7 opérationsAggregate documents
document.aggregateCe que tu vois dans n8n
Notes & cas d'usage
Exécute un pipeline d'agrégation sur une collection et en renvoie le résultat. Le calcul se fait dans la base, le workflow ne récupère que la sortie.
Paramètres clés
- Collection : la collection lue par le pipeline.
- Query : le pipeline lui-même, un tableau JSON d'étapes, sur le modèle du placeholder
[{ "$match": { "$gt": "1950-01-01" }, ... }]. Une expression comme{{ $json.depuis }}injecte dans une étape une valeur venue du nœud précédent.
Delete documents
document.deleteCe que tu vois dans n8n
Notes & cas d'usage
Supprime les documents qui correspondent à un filtre. L'opération ne demande rien d'autre qu'une collection et une requête, autrement dit la requête est le seul garde-fou entre le workflow et les données.
Paramètres clés
- Collection : celle où la suppression s'applique.
- Delete Query (JSON Format) : le filtre Mongo, sur le modèle du placeholder
{ "birth": { "$gt": "1950-01-01" } }. Passe-le d'abord dans Find documents et compte ce qui remonte.
Find documents
document.findCe que tu vois dans n8n
Notes & cas d'usage
Lit les documents qui correspondent à une requête et les transmet à la suite du workflow. C'est l'opération qui ouvre la plupart des branches MongoDB, faute de trigger côté base.
Paramètres clés
- Query (JSON Format) : le filtre Mongo, du type
{ "birth": { "$gt": "1950-01-01" } }. - Limit : le nombre maximal de documents renvoyés,
0signifiant aucun plafond. - Skip : le nombre de documents à sauter dans le résultat, le compagnon de Limit sur une grosse collection.
- Sort (JSON Format) : l'ordre du résultat, écrit
{ "field": -1 }pour un tri décroissant. - Projection (JSON Format) : les champs gardés ou écartés,
{ "_id": 0, "field": 1 }, pour ne pas trimballer des documents entiers.
Find and replace documents
document.findOneAndReplaceCe que tu vois dans n8n
Notes & cas d'usage
Cherche le document désigné par la clé de mise à jour et le remplace par un nouveau document, composé des champs listés dans l'opération.
Paramètres clés
- Update Key : la propriété qui décide du document concerné, le plus souvent
id, et elle doit exister aussi sur l'item entrant. - Fields : la liste des champs qui composent le nouveau document, séparés par des virgules, sous la forme
name,description. - Upsert : activé, un document est inséré quand la clé ne correspond à rien.
Find and update documents
document.findOneAndUpdateCe que tu vois dans n8n
Notes & cas d'usage
Retrouve le document porteur de la clé de mise à jour et y écrit les champs listés. Mêmes champs obligatoires que Find and replace documents, intention différente : ici le document est conservé et modifié.
Paramètres clés
- Update Key : la propriété qui sert à reconnaître le document,
iddans la plupart des collections. - Fields : les champs à écrire, séparés par des virgules, sur le modèle
name,description. - Date Fields : les champs à interpréter comme des dates Mongo et non comme du texte, ce qui compte dès qu'une comparaison de dates arrive plus loin.
Insert documents
document.insertCe que tu vois dans n8n
Notes & cas d'usage
Écrit les items entrants dans une collection sous forme de nouveaux documents. Aucune clé de mise à jour ici : l'opération ne cherche jamais un document existant.
Paramètres clés
- Collection : la collection qui reçoit les documents.
- Fields : la liste des champs retenus pour le nouveau document, séparés par des virgules,
name,description. Seul ce qui est nommé ici arrive dans MongoDB. - Use Dot Notation : à activer quand une date se cache dans un objet imbriqué et qu'il faut la rejoindre par un chemin.
Update documents
document.updateCe que tu vois dans n8n
Notes & cas d'usage
Applique les champs listés aux documents repérés par la clé de mise à jour. La version en lot de l'opération de recherche et mise à jour, pensée pour un paquet d'items qui arrivent ensemble.
Paramètres clés
- Collection : la collection dans laquelle la mise à jour atterrit.
- Update Key : la propriété qui désigne les documents à modifier,
idpar convention. - Upsert : sans lui, un item qui ne correspond à aucun document ne provoque aucune insertion.
Besoin d'aide pour automatiser MongoDB avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.


