Connecter Gmail à n8n : OAuth2, trigger, labels et brouillons (guide complet)

Gmail est à la fois le point d'entrée de la moitié des processus d'une petite équipe — demandes clients, factures fournisseurs, candidatures — et l'outil où l'on perd le plus de temps en tri manuel. Le node Gmail de n8n change l'équation : déclenchement sur les messages entrants, lecture, labels, brouillons et envoi, le tout combinable avec l'IA. Ce guide couvre la partie la plus piégeuse (l'authentification OAuth2 et son fameux token qui expire), le trigger et ses filtres, les opérations utiles, et les patterns qui rentabilisent l'intégration dès la première semaine.

Authentification : le passage obligé par Google Cloud

Gmail n'accepte que OAuth2 : pas de simple clé API. Le parcours complet — création du projet Google Cloud, écran de consentement, client OAuth, URL de redirection n8n — est détaillé pas à pas dans notre guide configurer OAuth2 Google dans n8n ; l'essentiel tient en quatre points :

1. Dans console.cloud.google.com, créez un projet et activez l'API Gmail (APIs & Services → Library) ;
2. Configurez l'écran de consentement OAuth (type External pour un compte @gmail.com), ajoutez votre adresse en test user ;
3. Créez un OAuth client ID de type Web application, avec l'OAuth Redirect URL affichée par le credential n8n en URI de redirection autorisée ;
4. Collez Client ID et Client Secret dans un credential Gmail OAuth2 côté n8n, puis validez le flux de connexion.

Le piège numéro un : tant que l'application reste en statut « Testing », Google fait expirer les refresh tokens au bout de 7 jours — votre workflow tourne une semaine, puis le credential tombe en erreur, systématiquement. Passez l'application en « In production » (bouton Publish app de l'écran de consentement) : pour un usage interne avec vos propres comptes, nul besoin de la validation complète de Google, l'avertissement « application non validée » au moment de la connexion est sans conséquence.

Le Gmail Trigger : du polling filtré, largement suffisant

Le Gmail Trigger interroge la boîte à intervalle régulier (à la minute au plus court) et émet un item par nouveau message correspondant à vos critères :

• Label : ne surveiller que Factures ou Support — le tri natif de Gmail devient le premier étage de votre workflow ;
• Search : toute la syntaxe de la barre de recherche Gmail fonctionne — from:client@exemple.fr has:attachment newer_than:2d, subject:(devis OR commande) ;
• Read Status : non-lus uniquement, avec option pour marquer lu après traitement ;
• Attachments : téléchargement des pièces jointes en données binaires, prêtes pour l'extraction de factures PDF par IA ou la gestion de fichiers volumineux.

Filtrez le plus tôt possible, côté Gmail : un trigger qui ne se déclenche que sur les bons messages économise des exécutions et simplifie tout l'aval — le même principe que pour n'importe quel webhook.

Les opérations du node Gmail

Quatre ressources couvrent l'essentiel :

• Message : Send (avec destinataires, HTML, pièces jointes), Reply (qui préserve le fil de conversation), Get / Get Many, Mark as Read/Unread, Add/Remove Label, Delete ;
• Draft : Create — l'opération sous-estimée du node, voir plus bas ;
• Label : créer et lister les labels, pour piloter le classement par programme ;
• Thread : récupérer une conversation complète, indispensable pour donner à une IA le contexte d'un échange avant de rédiger la suite.

Détail qui compte pour les workflows IA : le corps des messages arrive en HTML et/ou texte selon les options — pour alimenter un LLM, préférez le texte brut ou convertissez, un HTML d'email marketing pouvant tripler la consommation de tokens pour rien.

Trois patterns qui rentabilisent l'intégration

• Tri automatique par IA : Gmail Trigger → classification du message (demande, facture, spam, urgence) → pose de label + routage vers le bon canal. C'est le cœur de notre workflow de tri d'emails par IA et, en version complète, du Pack Inbox IA ;
• Brouillons IA relus par un humain : plutôt que d'envoyer automatiquement, l'opération Create Draft dépose la réponse rédigée par l'IA dans Gmail, rattachée à la conversation : relecture et envoi en un clic. Le pattern complet — ton, contexte client, garde-fous — est dans notre guide des brouillons de réponse par IA ;
• Digest quotidien : Schedule Trigger → Get Many sur les messages importants non traités → résumé LLM → un seul message Slack ou email le matin, au lieu de trente notifications.

Le problème que ces patterns attaquent est documenté depuis trente ans : l'étude fondatrice de Steve Whittaker et Candace Sidner, « Email overload: exploring personal information management of email » (CHI, 1996, voir sur Google Scholar), montrait déjà que l'email déborde de sa fonction de communication pour devenir un outil de gestion de tâches et d'archivage — rôles pour lesquels une boîte de réception est structurellement inadaptée. Le tri, le classement et la synthèse automatiques sont la réponse moderne à ce constat : rendre à la boîte mail son rôle de flux, et confier la gestion à des systèmes faits pour.

Quotas et bonnes pratiques d'envoi

L'API Gmail applique des quotas d'usage par utilisateur largement suffisants pour lire et classer, mais l'envoi reste borné par les limites d'expédition du compte (plus élevées sur Google Workspace que sur un compte gratuit). Pour des volumes marketing, Gmail n'est pas l'outil : gardez-le pour le transactionnel et les réponses individualisées, et passez par un service d'emailing dédié au-delà. Enfin, un compte de service avec délégation domaine est la voie propre pour automatiser des boîtes partagées en Google Workspace — configuration plus lourde, à réserver aux besoins multi-boîtes réels.

En résumé

Connecter Gmail à n8n, c'est un credential OAuth2 bien configuré (application publiée en production, sous peine d'expiration hebdomadaire), un trigger filtré à la source avec la syntaxe de recherche Gmail, et quatre ressources — Message, Draft, Label, Thread — qui couvrent tous les patterns utiles. Commencez par le tri automatique et les brouillons IA : ce sont les deux automatisations au retour le plus immédiat, et elles ne prennent qu'une heure à monter une fois l'OAuth2 en place.