Introduction
MCP (Model Context Protocol) Gmail est une extension puissante qui permet à Claude d'accéder et de gérer vos emails directement depuis Claude Desktop. Cette intégration ouvre des possibilités infinies pour automatiser et améliorer votre gestion d'emails avec l'aide de l'intelligence artificielle.
Qu'est-ce que MCP Gmail ?
MCP Gmail est un serveur de contexte qui crée un pont entre Claude Desktop et votre compte Gmail. Une fois configuré, Claude peut :
- Lire vos emails et les résumer
- Envoyer des emails automatiquement
- Gérer vos labels et dossiers
- Créer et appliquer des filtres
- Télécharger des pièces jointes
- Trier et organiser votre boîte de réception
Imaginez demander à Claude "Résume les 10 derniers emails de mon client ABC" ou "Envoie une réponse professionnelle à cet email". C'est maintenant possible !
Prérequis
Avant de commencer, assurez-vous que vous avez :
- Claude Desktop installé sur votre Mac
- Un compte Google actif
- Node.js et npm installés sur votre système
- Accès à Google Cloud Console
Étape 1 : Configuration de Google Cloud
1.1 Créer un projet Google Cloud
- Allez sur https://console.cloud.google.com/
- Cliquez sur le projet sélectionné en haut
- Cliquez sur "NEW PROJECT"
- Donnez un nom à votre projet (ex: "Claude Gmail MCP")
- Cliquez sur "CREATE"
1.2 Activer l'API Gmail
- Une fois le projet créé, allez dans "APIs & Services" > "Library"
- Cherchez "Gmail API"
- Cliquez dessus et appuyez sur "ENABLE"
1.3 Créer les identifiants OAuth
- Allez dans "APIs & Services" > "Credentials"
- Cliquez sur "+ Create Credentials"
- Sélectionnez "OAuth Client ID"
- Choisissez "Desktop application"
- Cliquez sur "CREATE"
- Téléchargez le fichier JSON (bouton de téléchargement)
1.4 Configurer l'écran de consentement OAuth
- Allez dans "APIs & Services" > "OAuth consent screen"
- Vérifiez que le type d'utilisateur est "External"
- Assurez-vous que la validation n'est pas requise
- Descendez jusqu'à "Test users"
- Cliquez sur "+ Add users"
- Entrez votre adresse Gmail
- Cliquez "Add"
1.5 Vérifier les URIs autorisées
- Retournez dans "Credentials"
- Cliquez sur votre Client ID OAuth
- Vérifiez que
http://localhost:3000/oauth2callbackest dans la liste des "URIs de redirection autorisés" - Si ce n'est pas là, ajoutez-le et sauvegardez
Étape 2 : Configuration locale et authentification
2.1 Créer le dossier Gmail MCP
Ouvrez votre terminal et exécutez :
mkdir -p ~/.gmail-mcp
2.2 Placer le fichier de clés
Déplacez le fichier gcp-oauth.keys.json que vous avez téléchargé depuis Google Cloud :
mv ~/Downloads/gcp-oauth.keys.json ~/.gmail-mcp/
2.3 Lancer l'authentification
Exécutez la commande d'authentification :
npx @gongrzhe/server-gmail-autoauth-mcp auth
2.4 Compléter le processus d'authentification
- Vous verrez une URL qui commence par
https://accounts.google.com/o/oauth2/v2/auth?... - Copiez cette URL complète
- Ouvrez-la dans votre navigateur
- Connectez-vous avec votre compte Google
- Autorisez l'accès quand Google vous le demande
- Vous serez redirigé vers
http://localhost:3000/oauth2callback?code=... - Copiez le code dans l'URL et collez-le dans votre terminal
- Attendez le message "Authentication successful!"
Étape 3 : Configuration de Claude Desktop
3.1 Modifier le fichier de configuration
Ouvrez le fichier de configuration de Claude Desktop :
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
3.2 Ajouter le serveur Gmail MCP
Insérez ce bloc dans la section mcpServers :
"gmail": {
"command": "npx",
"args": [
"@gongrzhe/server-gmail-autoauth-mcp"
]
}
3.3 Sauvegarder la configuration
- Appuyez sur
Ctrl + O - Appuyez sur
Entrée - Appuyez sur
Ctrl + X
3.4 Vérifier la configuration
Pour vérifier que le fichier a été correctement sauvegardé :
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json
Étape 4 : Activer le serveur dans Claude Desktop
- Fermez complètement Claude Desktop
- Rouvrez l'application
- Vous devriez voir une indication que le serveur Gmail est actif
Utilisation pratique
Une fois configuré, vous pouvez demander à Claude des choses comme :
- "Lis mes 5 derniers emails et résume-les"
- "Envoie un email à [adresse] avec ce contenu"
- "Crée un label 'Urgent' pour mes emails"
- "Télécharge la pièce jointe de cet email"
- "Montre-moi tous les emails de [personne]"
- "Classe mes emails par importance"
Dépannage
Erreur : "OAuth keys file not found"
Assurez-vous que gcp-oauth.keys.json est dans ~/.gmail-mcp/
Erreur 403 : "access_denied"
- Vérifiez que votre email est ajouté en tant qu'utilisateur de test
- Vérifiez que l'URI
http://localhost:3000/oauth2callbackest autorisé - Attendez quelques minutes que les changements se propagent
Le serveur Gmail n'apparaît pas dans Claude
- Redémarrez Claude Desktop complètement
- Vérifiez la syntaxe JSON de votre fichier de configuration
Conclusion
Félicitations ! Vous avez maintenant configuré MCP Gmail avec Claude Desktop. Cette intégration ouvre des possibilités infinies pour automatiser et améliorer votre gestion d'emails avec l'aide de l'intelligence artificielle.
MCP Gmail est juste le début. Il existe d'autres serveurs MCP pour le système de fichiers, les bases de données, et bien d'autres outils. Explorez les possibilités et transformez votre workflow !
Consultez la documentation officielle de MCP et Google Cloud pour découvrir d'autres fonctionnalités avancées.