Connectez votre boîte à Gemini CLI
avec une seule entrée de réglages
Donnez une vraie boîte à Gemini CLI. Lisez, recherchez, envoyez, répondez, transférez, planifiez et organisez vos e-mails depuis le terminal, dans toutes les boîtes que vous avez connectées.
Ajoutez une entrée sous mcpServers dans ~/.gemini/settings.json avec le champ httpUrl et https://mcpemails.com/api/mcp. À la première connexion, la CLI découvre les métadonnées OAuth et ouvre d'elle-même le flux dans le navigateur.
Comment Gemini CLI se connecte : OAuth, sans clé API
Gemini CLI exécute le flux OAuth MCP standard auprès de ce serveur. Il s'enregistre lui-même via l'enregistrement dynamique de client RFC 7591, donc aucun client ID à créer, et s'autorise avec un code d'autorisation plus 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 Gemini CLI.
| 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 Gemini CLI à 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.
Ouvrez votre settings.json
Modifiez ~/.gemini/settings.json pour tous les projets, ou .gemini/settings.json dans un seul projet.
Ajoutez le serveur
Ajoutez l'entrée ci-dessous sous mcpServers. Ici, le champ pour un serveur Streamable HTTP est httpUrl.
Connectez-vous
À la première connexion, la CLI découvre automatiquement OAuth à partir des métadonnées du serveur et ouvre le flux dans le navigateur. Approuvez les autorisations que la CLI doit détenir.
{
"mcpServers": {
"mcpemails": {
"httpUrl": "https://mcpemails.com/api/mcp"
}
}
}Documentation officielle de Gemini CLI sur les serveurs MCP distants : https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md
Vous ne savez pas quelle boîte connecter en premier ? Voir le tableau de compatibilité des fournisseurs
Ce qui fait trébucher avec Gemini CLI
httpUrl n'est pas le même champ que url, et la différence, c'est le transport
Dans les réglages de Gemini CLI, httpUrl désigne un serveur Streamable HTTP, ce qu'est celui-ci. D'autres clés du même objet sélectionnent d'autres transports. Un extrait copié d'un guide Cursor, qui utilise url, ne vous donnera pas ici une connexion Streamable HTTP fonctionnelle.
La découverte rend tout cela sans configuration, et elle part d'un 401
Inutile de dire à la CLI où s'authentifier. Un appel non authentifié reçoit un 401 dont l'en-tête WWW-Authenticate pointe vers nos métadonnées de ressource protégée, qui nomment le serveur d'autorisation, dont les métadonnées nomment les points de terminaison d'enregistrement, d'autorisation et de jeton. Cette chaîne explique pourquoi il n'y a aucun client ID à créer et rien à coller en dehors de l'URL.
Une CLI sur une machine partagée ou sans interface graphique préfère la voie de la clé
Le flux dans le navigateur a besoin d'un navigateur. Sur un agent de build ou une machine partagée, la configuration honnête est une clé API bearer limitée précisément à ce que cette automatisation doit faire, gardée dans l'environnement plutôt que dans un fichier de réglages commité.
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.
Gemini CLI et l’e-mail : vos questions
Comment connecter l'e-mail à Gemini CLI ?
Ajoutez une entrée sous mcpServers dans ~/.gemini/settings.json avec httpUrl défini sur https://mcpemails.com/api/mcp. À la première connexion, la CLI découvre OAuth à partir des métadonnées du serveur et ouvre le flux dans le navigateur. Elle dispose alors d'outils pour lire, rechercher, envoyer, répondre, transférer, organiser et planifier des e-mails.
Dois-je utiliser url ou httpUrl ?
httpUrl. Dans les réglages de Gemini CLI, cette clé sélectionne le transport Streamable HTTP, celui que parle ce serveur. Copier une entrée url depuis un autre client est la raison habituelle pour laquelle le serveur apparaît dans la liste sans fournir aucun outil.
Est-ce la même chose que le serveur MCP Gmail publié par Google ?
Non. Google publie un serveur MCP Workspace qui couvre Gmail en plus de ses autres services, et pour Gmail seul dans un workflow entièrement Google, c'est le chemin le plus court. MCPEmails existe pour le cas où toutes les boîtes ne sont pas chez Google, et où la même URL doit aussi fonctionner dans Claude, Cursor et ChatGPT.
Quelles boîtes Gemini CLI 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 qui parle 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, donc aucun UUID à coller nulle part.
Gemini CLI 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 : une clé ou un jeton sans cette autorisation ne peut rien envoyer du tout. En 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 à Gemini CLI
Une entrée de réglages, une connexion. Une boîte gratuite pour toujours, sans carte bancaire.