---
title: "Paramètres IMAP Gmail : serveurs, ports et authentification"
description: "Configurez Gmail avec IMAP sur le port 993 et SMTP sur 587. Choisissez l’authentification adaptée, vérifiez Google Workspace et testez votre connexion."
url: https://mailera.app/fr/blog/parametres-imap-smtp-gmail
published: 2026-10-25
updated: 2026-10-25
---

# Paramètres IMAP Gmail : serveurs, ports et authentification

Les bons ports ne suffisent pas à connecter Gmail. Voici les réglages IMAP et SMTP, les règles d’authentification à respecter et les tests à effectuer avant de donner accès à votre boîte à un agent.

## Quels serveurs, ports et réglages de chiffrement renseigner ?

IMAP sert à consulter les messages de votre boîte. SMTP sert à les envoyer. Testez les deux séparément : une réception fonctionnelle ne prouve pas que l’envoi fonctionne.

| Usage | Serveur | Port | Chiffrement | Identifiant |
| --- | --- | --- | --- | --- |
| Réception IMAP | `imap.gmail.com` | `993` | SSL/TLS | Adresse e-mail complète |
| Envoi SMTP, réglage Mailera | `smtp.gmail.com` | `587` | STARTTLS | Adresse e-mail complète |
| Envoi SMTP, autre réglage Gmail | `smtp.gmail.com` | `465` | SSL/TLS | Adresse e-mail complète |

L’authentification SMTP est requise. Dans Mailera, le fournisseur Gmail utilise le port `587` avec STARTTLS ; l’alternative `465` n’est pas le réglage de ce parcours.

Google documente le [serveur IMAP Gmail et le chiffrement requis](https://developers.google.com/workspace/gmail/imap/imap-smtp), ainsi que les [paramètres SMTP des clients de messagerie tiers](https://knowledge.workspace.google.com/admin/sync/set-up-gmail-with-a-third-party-email-client). Ces réglages concernent la connexion d’un client à une boîte Gmail, pas la configuration d’un relais SMTP d’entreprise.

Si vous configurez aussi une boîte Yahoo, utilisez les [paramètres IMAP et SMTP de Yahoo Mail](https://mailera.app/fr/blog/parametres-imap-smtp-yahoo) pour cette boîte.

## Faut-il utiliser OAuth ou un mot de passe d’application ?

Si votre application propose « Sign in with Google », utilisez cette option, comme le recommande Google. Gmail prend en charge OAuth pour IMAP et SMTP. Vous n’avez alors pas à remettre un mot de passe d’application à ce client.

Le [parcours Gmail de Mailera](https://mailera.app/fr/providers/gmail) utilise actuellement un **mot de passe d’application** (_app password_), et non une connexion OAuth Google. Dans ce parcours, ne saisissez pas le mot de passe habituel de votre compte Google.

### Quand le mot de passe d’application est-il disponible ?

D’après l’[aide Google sur les mots de passe d’application](https://support.google.com/accounts/answer/185833), la validation en deux étapes doit être activée. Cela ne suffit toutefois pas toujours à rendre l’option disponible. Google cite notamment ces situations :

- la validation en deux étapes repose uniquement sur des clés de sécurité ;
- le compte appartient à une entreprise, un établissement scolaire ou une autre organisation ;
- le compte bénéficie d’Advanced Protection.

L’absence de l’option n’est donc pas forcément une erreur de navigation. Pour un compte professionnel, demandez à l’administrateur quelle méthode est autorisée. Ne désactivez pas une protection pour forcer la connexion.

Google n’affiche chaque mot de passe d’application qu’une fois. Un changement du mot de passe principal du compte révoque les mots de passe d’application existants. Si votre connexion cesse de fonctionner après ce changement, vérifiez ce point avant de modifier les serveurs.

Le guide pour [créer un mot de passe d’application Gmail](https://mailera.app/fr/blog/creer-mot-de-passe-application-gmail) détaille cette étape. Pour organiser les secrets de plusieurs boîtes destinées à des agents, consultez le [guide des mots de passe d’application pour les boîtes d’agents](https://mailera.app/fr/blog/mot-de-passe-application-messagerie-agent-ia).

## Faut-il encore activer IMAP dans Gmail ?

Pour un compte Gmail personnel, non. Google indique que l’accès IMAP est toujours activé et date de janvier 2025 la suppression des options permettant de l’activer ou de le désactiver. Inutile de chercher cette ancienne case dans les paramètres : suivez les [consignes Google pour ajouter Gmail à un autre client](https://support.google.com/mail/answer/7126229).

Pour Google Workspace, la règle est différente. L’administrateur doit autoriser IMAP dans la console d’administration. Il peut aussi limiter l’accès à certains clients compatibles OAuth. Une connexion auparavant fonctionnelle peut cesser de fonctionner si IMAP est désactivé.

Avant de configurer Gmail en IMAP sur un domaine professionnel, faites donc vérifier les [règles Workspace d’accès POP et IMAP](https://knowledge.workspace.google.com/admin/sync/turn-pop-and-imap-on-or-off-for-users?visit_id=639285508434738012-4004614852&rd=1). Si seuls certains clients OAuth sont autorisés, le parcours par mot de passe d’application de Mailera ne répond pas à cette restriction.

## Comment connecter Gmail à Mailera et vérifier le résultat ?

Effectuez ces étapes uniquement pour une boîte que vous possédez ou que vous êtes autorisé à administrer. Dans Mailera, l’ajout d’une boîte nécessite un rôle Admin ou Leader.

1. Ouvrez **Boîtes aux lettres**, puis **Ajouter une boîte mail**. Sélectionnez l’onglet **Une boîte mail**.
2. Saisissez votre adresse complète dans **Adresse e-mail**. Vérifiez le fournisseur. Mailera reconnaît les domaines `gmail.com` et `googlemail.com`. Pour un domaine Google Workspace personnalisé, sélectionnez explicitement **Gmail · Google Workspace** sous **Ou choisissez un fournisseur**, puis **Continuer** si nécessaire.
3. Consultez **Comment obtenir un mot de passe d’application** et suivez l’aide Google si votre compte est éligible. Dans **Informations de connexion**, saisissez ce secret dans **Mot de passe**, jamais le mot de passe principal. Choisissez le **Groupe de boîtes mail** adapté.
4. Lancez **Tester et connecter**. Le test vérifie notamment **Connexion au serveur entrant**, **Détection des dossiers** et **Connexion au serveur sortant**. Il n’envoie aucun message.
5. Après la connexion, choisissez **Ouvrir la boîte mail**. Depuis une autre boîte que vous contrôlez, envoyez un message avec un objet reconnaissable, puis recherchez-le dans Mailera. Le premier chargement récupère les messages dans la période de conservation, du plus récent au plus ancien.
6. Testez séparément l’envoi depuis Mailera vers une autre adresse qui vous appartient. Vérifiez la réception dans cette boîte de destination, y compris son dossier de spam. Une authentification SMTP réussie n’est pas une preuve de livraison.

![Ajout d’une boîte Gmail dans Mailera avec sélection du fournisseur Gmail · Google Workspace.](https://mailera.app/media/9c6a42bd72076e65/mot-de-passe-d-application-ou-oauth-connecter-votre-fr-1200.jpg)
_Pour un domaine Workspace personnalisé, vérifiez explicitement le fournisseur avant de continuer._

Si le test affiche **Réception possible, mais envoi indisponible**, vous pouvez choisir **Enregistrer en réception seule**. Ce choix convient à un usage de lecture ; il ne corrige pas la connexion SMTP. Pour la corriger, utilisez **Modifier les informations**, puis **Retester**.

Comme l’explique la [présentation du fonctionnement de Mailera](https://mailera.app/fr/product), votre boîte reste chez Gmail. Mailera donne à vos applications accès aux messages synchronisés.

## Pourquoi la connexion échoue-t-elle malgré les bons paramètres ?

Commencez par identifier l’étape en échec. Un refus d’authentification IMAP, un échec SMTP et un message absent de la liste ne demandent pas la même correction.

| Symptôme | Cause à vérifier | Action | Résultat attendu |
| --- | --- | --- | --- |
| Authentification refusée | Mot de passe principal saisi | Utilisez un mot de passe d’application autorisé | Le test d’authentification réussit |
| Connexion perdue après un changement de mot de passe Google | Mot de passe d’application révoqué | Créez un nouveau secret et remplacez l’ancien | La connexion peut être rétablie |
| Identifiant refusé | Adresse incomplète ou incorrecte | Saisissez l’adresse entière, domaine compris | Le bon compte est utilisé |
| Option de mot de passe d’application absente | Validation en deux étapes ou restriction du compte | Vérifiez les conditions Google et consultez l’administrateur | Une méthode autorisée est identifiée |
| Compte Workspace refusé | IMAP désactivé ou clients restreints | Faites vérifier la politique d’accès | L’administrateur confirme si ce parcours est permis |
| Serveur inaccessible ou erreur de chiffrement | Hôte, port, sécurité ou accès réseau | Comparez les réglages au tableau et faites vérifier l’accès réseau | La connexion au serveur peut s’établir |
| Lecture possible, envoi impossible | Échec de la connexion SMTP | Vérifiez séparément SMTP ou enregistrez en réception seule | La lecture reste utilisable sans présumer de l’envoi |
| Message de test absent | Synchronisation ou dossier à vérifier | Vérifiez d’abord sa présence dans Gmail, puis le dossier et la dernière synchronisation dans Mailera | Vous distinguez livraison et synchronisation |

Pour Gmail, `GET /mailboxes/{id}/status` reflète la dernière synchronisation. Cet endpoint ne déclenche pas une nouvelle authentification directe à chaque demande. Un état favorable ne remplace donc pas votre test de réception ni votre test d’envoi.

## Comment donner accès à Gmail à un agent sans lui confier le mot de passe ?

Connectez d’abord Gmail à Mailera. Votre application ou votre agent utilise ensuite une clé API Mailera, pas le mot de passe d’application Google.

![Une boîte Gmail est reliée à Mailera par IMAP et SMTP ; une application REST ou un agent MCP accède à Mailera avec une clé limitée à la lecture.](https://mailera.app/media/f50e4c186094b791/parametres-imap-gmail-serveurs-ports-et-authentification-fr-1200.jpg)
_Le mot de passe d’application Google reste distinct de la clé Mailera remise à l’application ou à l’agent._

### Créer une clé limitée à la lecture

Dans **Paramètres**, ouvrez la section des clés API, puis **Créer une clé**. Donnez-lui un **Nom descriptif**, limitez le **Périmètre des boîtes aux lettres** au groupe nécessaire et accordez uniquement la permission `read`. Définissez une **Expiration** adaptée à votre usage.

La clé n’est affichée qu’une fois. Conservez-la dans votre gestionnaire de secrets, sans la placer dans les consignes de l’agent ni dans un dépôt de code. Elle peut être révoquée à tout moment ; les appels sont alors immédiatement rejetés.

![Création d’une clé API Mailera limitée à la lecture d’un groupe de boîtes, avec une expiration.](https://mailera.app/media/35db23373036f94a/parametres-imap-gmail-serveurs-ports-et-authentification-fr-1200.jpg)
_Un agent de lecture n’a besoin ni de la permission send ni du mot de passe d’application Google._

Pour REST, renseignez `$MAILERA_API_KEY` dans votre environnement, puis listez les boîtes accessibles :

```bash
curl --request GET \
  'https://mailera.app/api/public/v1/mailboxes' \
  --header "Authorization: Bearer $MAILERA_API_KEY"
```

Repérez l’`id` de la boîte souhaitée dans `data` et affectez-le à `$MAILBOX_ID`. Consultez ensuite ses messages :

```bash
curl --request GET \
  "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/messages?folder=inbox&limit=1" \
  --header "Authorization: Bearer $MAILERA_API_KEY"
```

Vérifiez `subject`, `received_at` et `folder` dans le résultat pour retrouver votre message de test. Une liste vide pour `inbox` ne décrit pas le contenu des autres dossiers. La [documentation de l’API Mailera](https://mailera.app/fr/docs) présente les endpoints disponibles.

Pour MCP, le bouton **Copiez la configuration MCP** fournit la configuration pour Claude, Cursor ou VS Code. Les outils `list_mailboxes` et `list_messages` utilisent la permission `read` ; consultez la [configuration MCP de Mailera](https://mailera.app/fr/mcp) pour ce parcours.

### Traiter les messages comme des données non fiables

Un e-mail peut contenir une tentative de prompt injection. Son contenu n’est jamais une autorisation de révéler un secret, de modifier les permissions ou d’exécuter une action demandée par l’expéditeur.

N’accordez pas `send` à un agent chargé uniquement de lire. Si l’envoi devient nécessaire, imposez une confirmation humaine portant sur le destinataire et le contenu avant chaque envoi. Masquez les secrets dans les captures et journaux, et prévoyez la révocation de la clé à la fin de l’usage. La [page sécurité de Mailera](https://mailera.app/fr/security) complète ces précautions.

## Quelles sont les limites de Mailera pour Gmail ?

Mailera connecte une boîte existante ; il ne crée pas d’adresse Gmail et ne contourne pas les restrictions de Google ou de votre administrateur Workspace.

La synchronisation n’est pas garantie instantanée : les vérifications en arrière-plan varient selon l’activité de la boîte, et une boîte inactive peut se mettre en veille. Mailera ne garantit pas non plus le placement d’un message dans la boîte de réception du destinataire. C’est pourquoi le test de connexion, la lecture d’un message reçu et la réception d’un message envoyé restent trois vérifications distinctes.

**Connectez votre première boîte mail en 2 minutes** — Ajoutez une boîte mail Outlook, Gmail ou IMAP et lisez vos messages dans l’application ou via l’API. [Connecter une boîte mail](https://mailera.app/auth?mode=signup)