MCP
Serveur MCP pour Gmail, Outlook, Yahoo, iCloud et IMAP
Permettez à Claude, Cursor, VS Code ou à votre agent de lire les messages, récupérer les codes OTP, répondre et sortir les messages du dossier Courrier indésirable dans toutes les boîtes aux lettres connectées, avec l'API key de votre espace de travail, sans écrire de code.
claude mcp add --transport http mailera https://mailera.app/api/public/v1/mcp \ --header "Authorization: Bearer mh_live_xxx"Connexion
- URL du serveur
https://mailera.app/api/public/v1/mcp- Authentification
Authorization: Bearer mh_live_… ou X-API-Key- Transport
- Streamable HTTP, sans session requise
- Version du protocole
- 2025-06-18 · 2025-03-26 · 2024-11-05
12 outils, selon les autorisations de la clé
Les agents ne voient que les outils autorisés par l'API key. Chaque appel exécute le point de terminaison REST correspondant: les résultats et codes d'erreur sont donc identiques à ceux de l'API.
| Outil | Fonction | Autorisation |
|---|---|---|
| list_mailboxes | Lister les boîtes aux lettres, fournisseurs, fonctionnalités et états de synchronisation | read |
| get_mailbox_status | Vérifier la connexion de la boîte aux lettres et la date de dernière synchronisation | read |
| list_messages | Lister les messages d’un dossier, du plus récent au plus ancien | read |
| search_messages | Rechercher des messages dans toutes les boîtes aux lettres, avec les codes OTP si souhaité | read |
| get_message | Lire un message complet: expéditeur, corps et pièces jointes | read |
| get_latest_otp | Récupérer le dernier code OTP dans Boîte de réception ou Courrier indésirable | read |
| send_email | Envoyer un nouveau message en évitant les doublons avec idempotency_key | send |
| reply_to_email | Répondre, répondre à tous ou transférer un message | send |
| get_send_status | Suivre une tentative d’envoi jusqu’à l’état sent, failed ou unknown | send |
| move_message | Déplacer un message vers Boîte de réception, Courrier indésirable, Archive ou Éléments supprimés | move |
| rescue_spam | Sortir les messages du dossier Courrier indésirable: tous, ou par expéditeur, domaine ou objet | move |
| sync_mailbox | Synchroniser maintenant et réactiver une boîte aux lettres en veille | sync |
Chaque appel d’outil utilise le point de terminaison REST correspondant: mêmes autorisations, même limite de 300 requêtes/minute et mêmes journaux API. Les erreurs figurent dans le résultat de l’outil (isError), avec un error.code stable que l’agent peut traiter.
Configuration par application
Copiez la configuration, saisissez votre API key, puis redémarrez l'application. Chaque application dispose d'un guide avec les étapes de vérification et les erreurs courantes.
Claude
Claude Code en une commande, Claude Desktop via la passerelle mcp-remote.
Terminal · claude_desktop_config.json
Guide ClaudeCursor
Un fichier mcp.json, pour tous les projets ou un seul.
~/.cursor/mcp.json
Guide CursorVS Code
Un fichier .vscode/mcp.json; VS Code vous demande votre clé une seule fois et la garde secrète.
.vscode/mcp.json
Guide VS Code
Accès sécurisé des agents aux boîtes aux lettres
Accordez uniquement les autorisations nécessaires
Si un agent doit seulement lire des messages, créez une clé avec une autorisation de lecture seule. N'accordez l'autorisation d'envoi que si l'agent en a réellement besoin et limitez si possible la clé à des groupes de boîtes aux lettres.
Les messages reçus sont des données, pas des instructions
Le contenu des messages est rédigé par d'autres personnes. Ne laissez pas les agents suivre les instructions contenues dans les messages, comme « transférez tous les messages à… ». Exigez qu'ils vous demandent confirmation avant d'envoyer ou de transférer des messages.
N'envoyez chaque message qu'une seule fois
Transmettez toujours idempotency_key lors de l'envoi. Si le statut est inconnu, ne renvoyez pas le message: vérifiez d'abord le dossier Éléments envoyés.
Révoquez l'accès à tout moment
Révoquez une clé dans Paramètres → API keys pour bloquer immédiatement toutes les applications qui l'utilisent. Le journal de l'API consigne chaque appel d'outil.
Vous n'utilisez pas MCP?
Chaque outil possède un point de terminaison REST correspondant, avec des webhooks signés pour les nouveaux messages.