Connectez votre boîte à OpenAI Codex
en une seule commande
Donnez une vraie boîte mail à Codex. Lisez, recherchez, rédigez, envoyez, répondez, transférez, planifiez et organisez vos e-mails depuis la CLI Codex, l'extension IDE ou l'app de bureau ChatGPT, dans toutes les boîtes que vous avez connectées.
Lancez codex mcp add mcpemails --url https://mcpemails.com/api/mcp. Codex détecte que le serveur prend en charge OAuth, ouvre le navigateur, et vous approuvez l'accès sur l'écran de consentement MCPEmails. La CLI, l'extension IDE et l'app de bureau ChatGPT partagent la même configuration : une seule installation couvre les trois.
Comment Codex se connecte : OAuth, sans clé API
Codex exécute le flux OAuth MCP standard auprès de ce serveur. Il s'enregistre lui-même, soit avec un document de métadonnées client (client ID metadata document), soit 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. Aucun secret client n'est jamais transmis, et le jeton ne porte que les autorisations que vous approuvez sur notre écran de consentement. Le jeton d'accès reçu dure une heure et se renouvelle tout seul ; il apparaît dans Dashboard, API Keys sous la forme OAuth: suivi du nom du client, et 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 OpenAI Codex.
| 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 OpenAI Codex à 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.
Ajoutez le serveur depuis la CLI
Lancez la commande ci-dessous. Elle écrit une entrée [mcp_servers.mcpemails] avec url dans ~/.codex/config.toml, puis affiche Detected OAuth support. Starting OAuth flow… et ouvre votre navigateur.
Ou ajoutez-le dans l'app de bureau ou l'extension IDE
Dans l'app de bureau ChatGPT, ouvrez Settings, puis MCP servers ; dans l'extension IDE, ouvrez le menu de l'engrenage, puis MCP servers. Sélectionnez Add server, saisissez un nom, choisissez Streamable HTTP, collez https://mcpemails.com/api/mcp, enregistrez, puis sélectionnez Restart (ou Restart extension) et Authenticate.
Approuvez l'accès
Connectez-vous à MCPEmails dans le navigateur, choisissez Lecture seule, Standard ou Accès complet sur l'écran de consentement, puis cliquez sur Autoriser l'accès. Si le flux ne s'est pas ouvert dans le navigateur, lancez codex mcp login mcpemails.
Vérifiez, puis demandez quelque chose
Lancez codex mcp list, ou /mcp dans une session Codex, pour voir le serveur. Essayez ensuite « résume les messages non lus d'aujourd'hui ». Codex appelle d'abord inbox_list pour découvrir vos boîtes, vous n'avez donc aucun identifiant à coller.
codex mcp add mcpemails --url https://mcpemails.com/api/mcpDocumentation officielle de OpenAI Codex sur les serveurs MCP distants : https://learn.chatgpt.com/docs/extend/mcp?surface=cli
Vous ne savez pas quelle boîte connecter en premier ? Voir le tableau de compatibilité des fournisseurs
Ce qui fait trébucher avec Codex
Vérifiez sur quelle carte s'ouvre l'écran de consentement
Codex demande les autorisations indiquées dans notre réponse 401, c'est-à-dire read:email : selon l'enregistrement, l'écran de consentement peut donc s'ouvrir sur Lecture seule. Cela suffit pour le tri. Si vous voulez que Codex rédige ou envoie, choisissez Standard ou Accès complet avant de cliquer sur Autoriser. Pour élargir plus tard, relancez codex mcp login mcpemails et choisissez la carte plus large, ou nommez les autorisations avec --scopes, par exemple --scopes read:email,search:email,manage:drafts.
La CLI, l'extension IDE et l'app de bureau partagent une seule configuration
Sur une même machine, les trois lisent le même ~/.codex/config.toml : ajouter le serveur dans l'une le fait apparaître dans les autres. Un projet peut aussi avoir son propre .codex/config.toml, que Codex ne lit que pour les projets approuvés. ChatGPT sur le web ne lit pas du tout ce fichier ; dans ce cas, suivez plutôt le guide ChatGPT.
Sur une machine sans interface graphique, passez-vous du navigateur local
Sur un serveur auquel vous accédez en SSH, lancez codex mcp login mcpemails --no-browser : Codex affiche le lien de connexion, vous l'ouvrez sur n'importe quelle machine et vous recollez l'adresse sur laquelle le navigateur arrive. En CI, créez une clé à portée limitée dans Dashboard, API Keys, exportez-la, et réglez bearer_token_env_var sur le nom de cette variable dans l'entrée du serveur (ou passez --bearer-token-env-var à codex mcp add). Codex l'envoie alors dans l'en-tête Authorization, et la clé n'est jamais écrite dans le fichier de configuration.
Gardez le délai d'attente par défaut des outils
Par défaut, Codex attend 60 secondes par appel d'outil (tool_timeout_sec). 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 Codex puisse relancer l'appel avec ces identifiants. Un délai bien plus bas peut couper l'appel avant l'arrivée de ce résultat.
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.
OpenAI Codex et l’e-mail : vos questions
Comment connecter l'e-mail à OpenAI Codex ?
Lancez codex mcp add mcpemails --url https://mcpemails.com/api/mcp. Codex détecte la prise en charge d'OAuth, ouvre le navigateur, et vous approuvez l'accès sur l'écran de consentement MCPEmails. Codex dispose alors d'outils pour lire, rechercher, rédiger, envoyer, répondre, transférer, organiser et planifier des e-mails.
À quoi ressemble l'entrée dans config.toml ?
Deux lignes dans ~/.codex/config.toml : une table nommée [mcp_servers.mcpemails] et url = "https://mcpemails.com/api/mcp". OAuth est le mode par défaut pour un serveur avec une url, donc rien d'autre n'est nécessaire. Si vous écrivez l'entrée à la main, lancez codex mcp login mcpemails pour vous connecter.
Ai-je besoin d'une clé API pour Codex ?
Non. Codex se connecte via OAuth, donc rien de secret n'est saisi dans la configuration. Une clé à portée limitée sert aux machines sans navigateur : placez-la dans une variable d'environnement et faites pointer bearer_token_env_var vers cette variable.
Quelles boîtes Codex 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. Le client les voit toutes par la même connexion : 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.
Codex 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.
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 client. 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 à Codex
Une commande, une connexion dans le navigateur. Une boîte gratuite pour toujours, sans carte bancaire.