Connectez votre boîte à OpenClaw
comme serveur MCP distant
Laissez l'agent personnel auquel vous écrivez déjà lire, rechercher, rédiger, envoyer, répondre, transférer et classer vos e-mails dans toutes les boîtes que vous avez connectées, via un seul point de terminaison MCP et une seule connexion.
Arrêtez la Gateway avec openclaw gateway stop, lancez openclaw mcp add mcpemails --url https://mcpemails.com/api/mcp --transport streamable-http --auth oauth, puis openclaw mcp login mcpemails et approuvez dans le navigateur. Redémarrez la Gateway avec openclaw gateway start.
Comment OpenClaw se connecte : OAuth, sans clé API
Le client MCP intégré d'OpenClaw exécute le flux OAuth MCP standard pour un serveur HTTP enregistré avec auth: "oauth". Il s'enregistre lui-même via l'enregistrement dynamique de client RFC 7591, donc aucun client ID à créer, et obtient son autorisation via le flux code d'autorisation avec PKCE en S256. Le jeton ne porte que les autorisations que vous approuvez sur notre écran de consentement, dure une heure et se renouvelle tout seul. OpenClaw le conserve sur la Gateway, et il apparaît dans Dashboard, API Keys sous le nom OAuth: OpenClaw MCP : c'est là que vous révoquez la connexion.
La seule valeur dont vous avez besoin
Tout ce qui figure sur cette page sert à faire entrer cette URL dans OpenClaw.
| Champ | Valeur |
|---|---|
| URL du serveur MCP | https://mcpemails.com/api/mcp |
| Transport | Streamable HTTP (MCP 2025-06-18) |
| Authentification | OAuth 2.1, code d’autorisation avec PKCE. Aucune clé API. |
Comment connecter OpenClaw à 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. Le plan gratuit inclut une boîte, pour toujours.
Enregistrez le serveur avec OAuth
Sur la machine qui fait tourner votre Gateway, lancez openclaw gateway stop, puis openclaw mcp add mcpemails --url https://mcpemails.com/api/mcp --transport streamable-http --auth oauth. Cela écrit l'entrée sous mcp.servers dans ~/.openclaw/openclaw.json. OpenClaw refuse de modifier les serveurs enregistrés tant que la Gateway tourne.
Connectez-vous depuis le terminal
La Gateway toujours arrêtée, lancez openclaw mcp login mcpemails. Ouvrez l'URL d'autorisation affichée et approuvez les autorisations que vous accordez à OpenClaw. OpenClaw récupère le retour du navigateur et enregistre les identifiants ; lancez ensuite openclaw gateway start.
Ou connectez-vous depuis la Control UI
Au lieu de passer par le terminal, démarrez la Gateway et ouvrez la Control UI sur sa propre adresse loopback ou sur une adresse HTTPS publique, puis allez dans Settings → MCP. En tant qu'administrateur, sélectionnez Sign in pour le serveur mcpemails, approuvez l'accès dans le navigateur, puis revenez dans Settings. Sur une adresse privée ou accessible uniquement via Tailscale, passez plutôt par le terminal.
Vérifiez la connexion
Lancez openclaw mcp status --verbose, qui fonctionne pendant que la Gateway tourne. S'il indique authorization-required, reconnectez-vous. Demandez ensuite à votre agent, sur n'importe quel canal, de lister vos boîtes.
openclaw mcp add mcpemails --url https://mcpemails.com/api/mcp --transport streamable-http --auth oauthDocumentation officielle de OpenClaw sur les serveurs MCP distants : https://docs.openclaw.ai/tools/mcp
Vous ne savez pas quelle boîte connecter en premier ? Voir le tableau de compatibilité des fournisseurs
Ce qui fait trébucher avec OpenClaw
Précisez le transport, sinon OpenClaw utilise SSE
Quand transport est absent d'une entrée HTTP, OpenClaw utilise sse. Ce serveur utilise Streamable HTTP : passez donc toujours --transport streamable-http, ou choisissez Streamable HTTP dans Settings. Dans une configuration écrite à la main, OpenClaw attend la syntaxe transport: "streamable-http" ; un type: "http" façon CLI n'est accepté que via openclaw mcp set ou corrigé par openclaw doctor --fix.
Les modifications en CLI exigent une Gateway arrêtée
openclaw mcp add, login, probe et doctor --probe refusent de s'exécuter tant qu'une Gateway locale détient l'état d'OpenClaw : arrêtez-la d'abord et redémarrez-la ensuite. Si la Gateway tourne sur un serveur et votre navigateur ailleurs, le retour loopback ne peut pas l'atteindre : copiez le code depuis le navigateur et terminez avec la commande openclaw mcp login mcpemails --code affichée.
Connexion partagée, boîte partagée
Par défaut, l'identifiant OAuth est partagé et géré par l'opérateur : tous les agents de cette Gateway utilisent la même connexion, donc toute personne qui peut écrire à votre agent peut lui demander de lire vos e-mails. Réservez-le aux canaux que vous êtes seul à utiliser, laissez send:email décoché sur l'écran de consentement si l'agent doit seulement lire, ou activez la validation humaine pour la boîte afin que chaque envoi attende une personne. OpenClaw propose aussi une connexion par demandeur, où chaque expéditeur connecte son propre compte ; il faut pour cela régler gateway.publicOrigin sur l'adresse HTTPS publique de la Gateway.
Un serveur enregistré n'est pas forcément un serveur qui fonctionne
OpenClaw enregistre une définition sans vérifier qu'elle fonctionne, et un serveur qui attend encore une connexion est simplement retiré des outils de l'agent au lieu de faire échouer l'échange. Si l'agent dit n'avoir aucun outil e-mail, lancez openclaw mcp status --verbose : authorization-required signifie qu'il faut refaire l'étape de connexion.
Limites à connaître
- Les requêtes sont limitées à 100 par minute, 1 000 par heure et 10 000 par jour et par clé, en plus du plafond d'actions facturables de votre plan.
- 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 réveille jamais votre agent de lui-même. Pour réagir au courrier entrant, interrogez la boîte à intervalles réguliers.
- 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.
OpenClaw et l’e-mail : vos questions
Comment connecter l'e-mail à OpenClaw ?
Sur la machine de la Gateway, arrêtez la Gateway, lancez openclaw mcp add mcpemails --url https://mcpemails.com/api/mcp --transport streamable-http --auth oauth, puis connectez-vous avec openclaw mcp login mcpemails et redémarrez la Gateway. Vous pouvez aussi vous connecter depuis Settings, MCP dans la Control UI. Votre agent dispose alors d'outils pour lire, rechercher, rédiger, envoyer, répondre, transférer, organiser et planifier des e-mails.
Ai-je besoin d'une clé API pour OpenClaw ?
Non. OpenClaw exécute lui-même le flux OAuth MCP et conserve le jeton sur la Gateway. Ses entrées HTTP acceptent aussi une table d'en-têtes statiques, donc une clé à portée limitée envoyée dans un en-tête Authorization Bearer fonctionne également, mais OpenClaw ignore les en-têtes Authorization statiques sur une entrée réglée sur auth oauth : choisissez l'un ou l'autre.
Puis-je ne montrer à mon agent qu'une partie des outils e-mail ?
Oui. Ajoutez --include avec une liste de noms d'outils séparés par des virgules, ou un motif comme 'email_*', quand vous lancez openclaw mcp add, ou réglez toolFilter sous le serveur dans la configuration. Cela réduit ce que l'agent voit. Ce qu'il a réellement le droit de faire reste fixé par les autorisations approuvées sur l'écran de consentement.
Quelles boîtes OpenClaw peut-il atteindre ainsi ?
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. Votre agent appelle d'abord inbox_list pour découvrir chaque boîte connectée et son identifiant, vous n'avez donc aucun UUID à coller nulle part.
OpenClaw peut-il envoyer un e-mail sans que je le voie ?
Seulement si vous l'y autorisez. L'envoi dépend de l'autorisation send:email : un jeton sans cette autorisation ne peut rien envoyer du tout. De plus, le propriétaire d'une boîte peut exiger une validation humaine dans le tableau de bord, qui retient chaque envoi, réponse, transfert, envoi de brouillon et envoi planifié jusqu'à ce qu'une personne le libère. Pour un agent qui tourne sans surveillance sur plusieurs canaux de discussion, mieux vaut utiliser les deux.
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 à votre agent. 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 OpenClaw
Un serveur, une connexion. Une boîte gratuite pour toujours, sans carte bancaire.