Connectez votre boîte à n8n
avec le MCP Client Tool
Donnez une vraie boîte mail à l'AI Agent de votre workflow n8n. Il peut lire, rechercher, rédiger, envoyer, répondre, transférer et classer des e-mails via un seul point de terminaison MCP, avec une clé dont les autorisations couvrent exactement ce que le workflow doit faire.
Dans votre workflow n8n, ajoutez un nœud MCP Client Tool sur l'entrée Tool de l'AI Agent. Réglez Endpoint sur https://mcpemails.com/api/mcp, Server Transport sur HTTP Streamable et Authentication sur Bearer Auth, puis collez une clé API de votre tableau de bord MCPEmails comme Bearer Token.
Comment n8n se connecte : un identifiant Bearer Auth qui contient une clé limitée
Le nœud MCP Client Tool envoie l'identifiant que vous lui associez, quel qu'il soit. Ce guide utilise l'identifiant Bearer Auth de n8n, qui place votre clé dans l'en-tête Authorization de chaque requête. Créez la clé dans votre tableau de bord et cochez uniquement les autorisations dont le workflow a besoin. Un workflow s'exécute souvent de façon planifiée, sans personne pour le surveiller : ce sont donc ces autorisations qui fixent la vraie limite. Les connexions par clé et les connexions OAuth atteignent le même point de terminaison et reçoivent le même catalogue d'outils.
La seule valeur dont vous avez besoin
Tout ce qui figure sur cette page sert à faire entrer cette URL dans n8n.
| Champ | Valeur |
|---|---|
| URL du serveur MCP | https://mcpemails.com/api/mcp |
| Transport | Streamable HTTP (MCP 2025-06-18) |
| Authentification | Authorization: Bearer, avec une clé API à portée limitée issue de votre tableau de bord. |
Comment connecter n8n à votre boîte
Quatre étapes. Les deux premières sont les mêmes pour tous les clients, les suivantes sont propres à celui-ci.
Créez un compte gratuit et connectez une boîte
Inscrivez-vous sur mcpemails.com, sans carte bancaire, puis allez dans Dashboard, Inboxes, Connect Inbox. Outlook et Microsoft 365 se connectent via la connexion Microsoft ; Gmail, iCloud, Fastmail, Yahoo, Zoho et Yandex demandent un mot de passe d'application ; tout le reste se connecte en IMAP et SMTP standard.
Créez une clé API à portée limitée
Dans Dashboard, API Keys, cliquez sur Create key. Donnez-lui le nom du workflow et cochez uniquement les autorisations nécessaires : read:email, search:email, send:email, manage:folders, delete:email, manage:drafts, manage:contacts, schedule:email et manage:automations. La clé se présente sous la forme mcpe_ suivi de 64 caractères hexadécimaux et ne s'affiche qu'une fois : copiez-la avant de fermer la fenêtre.
Ajoutez le MCP Client Tool à votre AI Agent
Ouvrez le workflow, cliquez sur le plus sous l'entrée Tool du nœud AI Agent et choisissez MCP Client Tool. Collez https://mcpemails.com/api/mcp dans Endpoint et réglez Server Transport sur HTTP Streamable.
Associez un identifiant Bearer Auth
Réglez Authentication sur Bearer Auth, créez un nouvel identifiant et collez la clé dans Bearer Token, sans rien devant. Laissez Tools to Include sur All, ou passez à Selected et choisissez uniquement les outils que ce workflow doit voir.
Documentation officielle de n8n sur les serveurs MCP distants : https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp/
Vous ne savez pas quelle boîte connecter en premier ? Voir le tableau de compatibilité des fournisseurs
Ce qui fait trébucher avec n8n
Collez la clé sans le mot Bearer
L'identifiant Bearer Auth de n8n ajoute lui-même Bearer et une espace. Si vous le tapez vous-même, le mot est envoyé deux fois et l'appel échoue avec une erreur 401. Si vous utilisez plutôt Header Auth, c'est l'inverse : Name vaut Authorization et Value vaut Bearer, une espace, puis la clé.
Un champ SSE Endpoint signale un ancien nœud
La version 1 du nœud MCP Client Tool n'avait qu'un champ SSE Endpoint et aucun choix de transport. Les versions actuelles affichent Endpoint et Server Transport. Ce serveur utilise le transport Streamable HTTP : si vous ne voyez que SSE Endpoint, ajoutez un nouveau nœud ou mettez n8n à jour. Si Server Transport indique Server Sent Events (Deprecated), passez-le sur HTTP Streamable.
Gardez le délai d'attente par défaut
Le nœud accorde 60 000 ms à chaque appel d'outil, une valeur réglable sous Options, Timeout. C'est suffisant même pour les traitements en masse : un déplacement ou une suppression sur un gros dossier atteint avant cela la limite de temps propre au serveur, s'arrête et renvoie un résultat marqué partial, avec les messages non traités listés dans remaining_message_ids, pour que l'agent puisse relancer l'appel avec ces identifiants. Un Timeout bien plus bas peut couper l'appel avant l'arrivée de ce résultat, et l'agent ne sait plus ce qui a été fait.
Tools to Include masque des outils ; les autorisations de la clé les interdisent
Le nœud ne liste jamais que les outils couverts par les autorisations de votre clé, car le serveur omet les autres dans tools/list. Choisir un sous-ensemble dans Tools to Include réduit encore la liste, ce qui aide le modèle à choisir, mais ne change rien à ce que la clé a le droit de faire. Définissez la limite sur la clé et servez-vous de Tools to Include pour garder l'agent concentré.
Limites à connaître
- Les requêtes sont limitées à 100 par minute, 1 000 par heure et 10 000 par jour et par clé. Un workflow qui boucle sur de nombreux éléments doit espacer ses appels ou répartir le travail entre plusieurs clés.
- Le serveur fonctionne uniquement en requête-réponse. Il n'y a ni webhooks ni événements déclenchés par le serveur, donc un nouveau message ne lance jamais un workflow de lui-même. Pour réagir au courrier entrant, démarrez le workflow avec un Schedule Trigger et demandez à l'agent de vérifier les messages non lus.
- Le courrier est récupéré en direct chez votre fournisseur à chaque appel et n'est jamais stocké. Seul le jeton OAuth ou le mot de passe d'application chiffré est conservé, donc un jeton révoqué ou un mot de passe de boîte modifié coupe l'accès immédiatement.
n8n et l’e-mail : vos questions
Comment connecter l'e-mail à un AI Agent n8n ?
Ajoutez un nœud MCP Client Tool sur l'entrée Tool de l'AI Agent. Réglez Endpoint sur https://mcpemails.com/api/mcp et Server Transport sur HTTP Streamable, choisissez Bearer Auth et collez une clé API de Dashboard, API Keys comme Bearer Token. L'agent dispose alors d'outils pour lire, rechercher, rédiger, envoyer, répondre, transférer, organiser et planifier des e-mails.
Puis-je appeler un outil e-mail sans AI Agent ?
Oui. Le nœud MCP Client autonome de n8n exécute un outil MCP comme une étape ordinaire du workflow, sans modèle qui décide quoi appeler. Saisissez la même adresse dans son champ MCP Endpoint URL, associez le même identifiant Bearer Auth, choisissez un outil et renseignez ses paramètres, par exemple email_read avec action réglé sur list et unread sur true. C'est adapté aux pipelines fixes dont les étapes ne changent jamais.
Pourquoi Bearer Auth plutôt que l'identifiant MCP OAuth2 ?
n8n propose aussi un identifiant MCP OAuth2. Ce guide utilise Bearer Auth parce que les autorisations d'une clé sont fixées à sa création et visibles dans votre tableau de bord, ce qui est plus simple à maîtriser pour un workflow qui tourne sans surveillance. Révoquer la clé dans Dashboard, API Keys arrête le workflow dès son appel suivant.
Le workflow peut-il envoyer des e-mails sans que personne ne vérifie ?
Seulement si vous l'y autorisez. L'envoi exige l'autorisation send:email : une clé sans cette autorisation ne peut rien envoyer du tout. Vous pouvez aussi activer la validation pour une boîte dans le tableau de bord : les envois, réponses, transferts, envois de brouillons et envois planifiés sont alors retenus, l'agent reçoit un résultat en attente, et un membre de l'espace de travail approuve ou rejette chacun d'eux avant que quoi que ce soit ne parte.
Quelles boîtes un workflow n8n peut-il atteindre ?
Outlook.com et Microsoft 365 via la connexion Microsoft, où un compte professionnel peut nécessiter qu'un administrateur informatique approuve l'application une fois ; Gmail, iCloud, Fastmail, Yahoo, Zoho et Yandex avec un mot de passe d'application ; et toute autre boîte compatible IMAP et SMTP sur les ports standard. Avec plusieurs boîtes connectées, l'agent appelle inbox_list pour trouver l'identifiant de chacune, vous n'avez donc aucun UUID à coder en dur dans le workflow.
Mes e-mails sont-ils stockés sur vos serveurs ?
Non. Chaque message est récupéré en direct chez votre fournisseur pour la requête qui l'a demandé, puis transmis directement à n8n. Seul le jeton OAuth ou le mot de passe d'application chiffré est conservé, pour que les appels suivants puissent s'authentifier. Supprimer la boîte dans le tableau de bord, ou révoquer l'accès chez votre fournisseur, coupe la connexion aussitôt.
Donnez une vraie boîte à votre agent n8n
Un point de terminaison, un identifiant Bearer Auth, une clé limitée. Sans carte bancaire.