Ressources · Intégration n8n

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

Pourquoi automatiser

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

Connexion

De quoi n8n a-t-il besoin pour joindre ta base ?

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

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

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

Actions

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.

Matrice ressources × opérations
RessourceUpdateDeleteAggregateCreateDropFindFind And ReplaceFind And UpdateInsertListUpdate
Search Index✓✓✓✓
Document✓✓✓✓✓✓✓

Search Index

4 opérations
01

Create Search Index

searchIndexes.createSearchIndex

Ce 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, vectorSearch ou search.
  • Index Definition : la définition en JSON, sur le modèle affiché dans le champ, { "type": "vectorSearch", "definition": {} }.
Cas d'usage
un catalogue produit stocké en documents devient cherchable depuis le site une fois l'index créé, dans la foulée de l'import.
02

Drop Search Index

searchIndexes.dropSearchIndex

Ce 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.
Cas d'usage
après une migration, l'index de test créé pour valider la bascule n'a plus de raison d'exister. Le workflow de nettoyage le retire avant de rendre la main.
03

List Search Indexes

searchIndexes.listSearchIndexes

Ce 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.
Cas d'usage
un inventaire mensuel des index d'une base, pour repérer ceux qui traînent depuis une expérimentation abandonnée.
04

Update Search Index

searchIndexes.updateSearchIndex

Ce 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.
Cas d'usage
un champ entre dans le périmètre de la recherche et la définition doit suivre, sans supprimer l'index ni le reconstruire.

Document

7 opérations
05

Aggregate documents

document.aggregate

Ce 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.
Cas d'usage
le récap du lundi matin, qui remonte des totaux déjà calculés au lieu de faire descendre toute la collection dans n8n.
06

Delete documents

document.delete

Ce 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.
Cas d'usage
la purge des journaux d'exécution stockés en base, qu'on garde quelques semaines puis qu'on efface par lot.
07

Find documents

document.find

Ce 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, 0 signifiant 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.
Cas d'usage
l'export quotidien vers une feuille de calcul, alimenté par les documents créés la veille.
08

Find and replace documents

document.findOneAndReplace

Ce 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.
Cas d'usage
une fiche produit qui arrive complète depuis l'outil de référence et écrase la version stockée, plutôt que de la compléter champ par champ.
09

Find and update documents

document.findOneAndUpdate

Ce 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, id dans 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.
Cas d'usage
le statut d'un abonné change chez l'outil d'emailing, le workflow reporte l'information sur le document qui lui correspond.
10

Insert documents

document.insert

Ce 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.
Cas d'usage
un formulaire branché sur un Webhook n8n dépose chaque réponse dans une collection, horodatage compris.
11

Update documents

document.update

Ce 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, id par convention.
  • Upsert : sans lui, un item qui ne correspond à aucun document ne provoque aucune insertion.
Cas d'usage
en fin de traitement, chaque document traité reçoit son marqueur, ce qui évite de le reprendre à l'exécution suivante.
Besoin d'aide

Besoin d'aide pour automatiser MongoDB avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

MongoDB et n8n, les questions qui suivent

01L'intégration MongoDB n8n est-elle gratuite ?
Côté n8n, oui. Le nœud MongoDB est livré avec n8n, donc rien à installer et aucun coût supplémentaire, que le workflow tourne sur n8n Cloud, l'offre hébergée par n8n, ou sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Un workflow se comporte de la même façon dans les deux cas. Ce que coûte la base MongoDB elle-même dépend de l'endroit où elle tourne et ne se traite pas ici. Le credential se crée une seule fois dans le menu Credentials, puis il est proposé dans la liste déroulante de tous les nœuds MongoDB, dans tous les workflows.
02Quels identifiants faut-il pour connecter MongoDB à n8n ?
Un credential MongoDB, avec un Configuration Type à choisir en premier. Connection String attend la chaîne copiée sous Database puis Connect puis Drivers, au format mongodb+srv, avec le nom d'utilisateur et le mot de passe de l'utilisateur de base à la place des marqueurs, plus le nom de la Database. Values demande les mêmes éléments champ par champ : Host, Database, User, Password et Port. Dans les deux cas il faut un utilisateur de base disposant des droits adaptés sur le serveur, et un Project Owner doit ajouter les adresses IP de n8n aux IP Access List Entries, dans Network Access. Use TLS ajoute les champs x.509 : CA Certificate, Public Client Certificate, Private Client Key et Passphrase.
03Quelles sont les limites du nœud MongoDB ?
Deux limites structurent la façon de construire. Il n'existe pas de trigger, donc rien dans n8n ne remarque qu'une autre application vient d'écrire un document. Et tous les filtres s'écrivent à la main en JSON dans un champ Query : un opérateur mal tapé donne un résultat vide plutôt qu'un message d'erreur. Find documents est la seule opération à proposer des Options de volume : Limit plafonne le nombre de documents renvoyés, avec 0 pour aucun plafond, Skip passe par-dessus ce qui a déjà été traité, Sort ordonne et Projection allège. Le credential ouvre une connexion à la base, pas une clé d'API : ce que les 11 opérations ne couvrent pas passe par Find documents ou Aggregate documents, avec une requête ou un pipeline JSON écrits à la main, pas par le nœud HTTP Request.
04Comment déclencher un workflow quand un document change dans MongoDB ?
Pas directement, puisque MongoDB n'a pas de nœud trigger dans n8n. Deux chemins le remplacent. Le Schedule Trigger lance le workflow à intervalle fixe et Find documents lit ce qui a changé depuis la fois précédente : la fraîcheur de la donnée vaut alors l'intervalle choisi. Autre option, l'application qui écrit dans la base appelle aussi un Webhook n8n, c'est-à-dire une URL que n8n expose et sur laquelle il attend, et le workflow récupère le changement au moment où il se produit. Le premier chemin consomme une exécution par intervalle même quand rien ne bouge, le second une par événement.
05n8n ou Make pour piloter MongoDB ?
La réponse tient surtout à l'endroit où les données ont le droit de se trouver. n8n s'installe sur ton propre serveur ou s'utilise sur n8n Cloud, alors que Make est hébergé uniquement, sans option d'auto-hébergement, et se facture à l'opération. Une collection qui contient des données interdites de sortie penche donc vers un n8n auto-hébergé, la connexion à la base ne quittant jamais le réseau. Un workflow qui insère quelques documents par jour tourne très bien sur l'un comme sur l'autre. La logique visuelle diffère aussi : n8n raisonne en nœuds et en expressions, Make en modules. Côté coût, une machine fixe d'un côté, un compteur d'opérations de l'autre.