1. Accéder à Google Cloud Console ;
2. Créer un nouveau projet ou sélectionner un projet existant ;
3. Saisir le nom du projet (par exemple, "gmail mcp agent") ;
4. Accepter les paramètres d'organisation et d'emplacement suggérés ;
5. Cliquer sur Créer et attendre l'initialisation du projet.

1. Depuis le menu latéral, aller dans "APIs & Services" → "Library" ;
2. Rechercher "Gmail API" ;
3. Sélectionner le premier résultat et cliquer sur "Activer" ;
4. Cette opération accorde à votre projet l'autorisation d'accéder aux fonctionnalités Gmail.

1. Accéder à l'onglet "Identifiants" ;
2. Si demandé, cliquer sur "Configurer l'écran de consentement" ;
3. Cliquer sur "Commencer" ;
4. Saisir le nom de l'application (par exemple, "gmail agent") ;
5. Saisir votre adresse e-mail ;
6. Sélectionner "Audience externe" pour le type d'utilisateur, si vous utilisez un compte Gmail général ;
7. Ressaisir votre adresse e-mail lorsque cela est demandé ;
8. Accepter la politique de gestion des données utilisateur ;
9. Cliquer sur Continuer puis Créer.

1. Cliquer sur "Créer un client OAuth" ;
2. Sélectionner "Application Web" ;
3. Accepter le nom suggéré ou le personnaliser ;
4. Cliquer sur "Ajouter un URI" ;
5. Saisir l'URI de redirection : http://localhost:3000/oauth2callback ;
6. Cliquer sur le bouton bleu Créer ;
7. Télécharger le fichier d'identifiants JSON ;
8. Renommer le fichier en : gsp-oauth.keys.json.

Accéder à votre répertoire racine/personnel :

• Mac : dossier personnel Users/user_name ou Windows : C:\Users\Your_Username\ ;
• Utiliser Command + Shift + . (Mac) ou Ctrl + Shift + . (Windows) pour afficher les fichiers cachés ;
• Créer un nouveau dossier nommé : .gmail-mcp ;
• Déplacer le fichier gsp-oauth.keys.json dans ce dossier ;
• Utiliser à nouveau Command + Shift + . pour masquer les dossiers.

Le serveur est configuré pour localiser automatiquement les identifiants dans ce répertoire.

• Ouvrir Claude avec Desktop Commander MCP installé. Pour une configuration rapide, utiliser la commande Smithery ;
• Dans une nouvelle conversation Claude, saisir l’invite :

run npx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude

• Pendant l’exécution, Claude demande l’autorisation d’utiliser Desktop Commander MCP. Cliquer sur Toujours autoriser ou Autoriser une fois ;
• Redirection vers une page d’authentification Google. Sélectionner le même e-mail utilisé pour le projet Cloud. Cliquer sur Autoriser pour accorder l’accès à Gmail. Attendre le message de réussite ;
• Redémarrer Claude Desktop. Le nouveau serveur devrait maintenant apparaître comme connecté.

• Copier l’invite et la coller dans une nouvelle conversation Claude ou une conversation déjà ouverte :

add next config block to claude config file
{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-gmail-autoauth-mcp"
      ]
    }
  }
}

• Exécuter l’invite → Claude mettra à jour le fichier de configuration.
• Vérifier que le bloc a bien été ajouté (optionnel). Aller dans Paramètres (raccourci : Cmd + ,) → Développeur → Modifier la configuration → ouvrir le fichier claude_desktop_config.json dans un éditeur de texte ;
• Fermer complètement et rouvrir Claude Desktop.

Mettre à jour le fichier de configuration

• Dans Claude Desktop, appuyer sur Command + , (Mac) ou Ctrl + , (Windows) ;
• Cliquer sur "Modifier la configuration" ;
• Ouvrir le fichier de configuration dans un éditeur de texte ;
• Copier le bloc de configuration ;

{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    },
    "gmail": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-gmail-autoauth-mcp"
      ]
    }
  }
}

• Coller ce bloc dans votre fichier de configuration Claude après le bloc de configuration précédent et avant les deux dernières accolades fermantes ;
• Enregistrer le fichier (Command/Ctrl + S) ;
• Fermer complètement et rouvrir Claude Desktop.