Analyser ses Emails avec l'IA : Guide Pratique Claude Code + Gmail

🎯 Ce Que Vous Allez Créer Link to heading

Imaginez pouvoir demander à votre ordinateur :

“Trouve tous les emails non lus de cette semaine qui parlent de factures” “Résume-moi les emails importants d’hier” “Liste les emails suspects reçus ce mois”

C’est exactement ce que vous allez construire dans ce tutoriel ! Nous allons créer un assistant personnel qui peut analyser vos emails Gmail en utilisant Claude Code, le tout en lecture seule pour une sécurité maximale.

Pourquoi ce tutoriel ? Link to heading

✅ Simple : Configuration en 30 minutes
✅ Sécurisé : Accès lecture seule uniquement
✅ Gratuit : Utilise l’API Gmail gratuite
✅ Puissant : Intelligence artificielle pour analyser vos emails
✅ Révocable : Vous pouvez couper l’accès en 1 clic

Ce dont vous avez besoin Link to heading

Un compte Gmail
Un ordinateur Linux (Ubuntu, Debian, Fedora, etc.)
30 minutes de votre temps
Aucune compétence en programmation requise !

🚀 Vue d’Ensemble : Comment Ça Marche ? Link to heading

     Vos Emails Gmail
           ↓
    [Gmail API - Lecture Seule]
           ↓
      [Serveur MCP]
           ↓
      [Claude Code]
           ↓
    Analyses Intelligentes !

L’idée : Claude peut “lire” vos emails (mais pas les modifier) et vous aider à les analyser avec l’intelligence artificielle.

Important : On commence avec zéro risque - Claude ne peut QUE lire. Pas de suppression, pas d’envoi, pas de modification.

📋 Partie 1 : Préparer Google Cloud (15 minutes) Link to heading

Étape 1.1 : Créer Votre Projet Link to heading

C’est comme créer un “dossier” pour votre projet dans Google Cloud.

Aller sur : console.cloud.google.com
Se connecter avec votre compte Gmail
Cliquer sur le menu déroulant des projets (en haut)
Cliquer sur “Nouveau projet”

Remplir :

Nom : Mon Assistant Email (ou ce que vous voulez)
Cliquer “Créer”

⏱️ Attendre 20 secondes… et voilà, votre projet est créé !

Étape 1.2 : Activer l’API Gmail Link to heading

Maintenant on “allume” l’API Gmail pour pouvoir lire vos emails.

Dans le menu ☰ → Cliquer “APIs et Services” → “Bibliothèque”
Rechercher : Gmail API
Cliquer dessus
Cliquer sur le gros bouton bleu “ACTIVER”

✅ Terminé ! Vous verrez “API activée”

Étape 1.3 : Configurer les Permissions (Important !) Link to heading

Ici on dit à Google : “Je veux seulement LIRE mes emails, rien d’autre”.

Navigation : Menu ☰ → APIs et Services → Écran de consentement OAuth

Choisir :

Type : Externe ✅
Cliquer “Créer”

Page 1 - Les infos de base :

Remplir simplement :

Nom de l’application : Mon Assistant Email
E-mail assistance : votre.email@gmail.com
E-mail développeur : votre.email@gmail.com

Le reste ? Laissez vide !

Cliquer “Enregistrer et continuer”

Page 2 - Les permissions (LA partie importante !) :

Cliquer “Ajouter ou supprimer des champs d’application”
Une fenêtre s’ouvre
Rechercher : gmail.readonly

Cocher UNIQUEMENT cette case :

✅ https://www.googleapis.com/auth/gmail.readonly

🔴 SUPER IMPORTANT : Ne cochez QUE celle-là ! C’est votre garantie que Claude ne peut que LIRE.

Cliquer “Mettre à jour”
Cliquer “Enregistrer et continuer”

Page 3 - Vous ajouter comme testeur :

Cliquer “+ Ajouter des utilisateurs”
Entrer votre email Gmail
Cliquer “Ajouter”
Cliquer “Enregistrer et continuer”

Page 4 - Résumé :

Vérifier que tout est bon, puis “Retour au tableau de bord”

Étape 1.4 : Télécharger Votre “Clé” Link to heading

Maintenant on récupère un fichier qui permet à votre ordinateur de se connecter.

Menu ☰ → APIs et Services → Identifiants
Cliquer le gros bouton “+ CRÉER DES IDENTIFIANTS”
Choisir “ID client OAuth 2.0”

Configurer :

Type : Application de bureau
Nom : Assistant Email Local
Cliquer “Créer”

Une fenêtre apparaît :

Cliquer “TÉLÉCHARGER JSON”
Le fichier se télécharge (nommé quelque chose comme client_secret_xxx.json)
Cliquer “OK”

🎉 Bravo ! Partie Google Cloud terminée. Le plus dur est fait !

💻 Partie 2 : Installation sur Votre Ordinateur (10 minutes) Link to heading

Étape 2.1 : Vérifier les Prérequis Link to heading

Ouvrez un terminal et tapez :

# Vérifier Node.js (devrait afficher v18 ou plus)
node --version

# Vérifier pnpm
pnpm --version

# Vérifier Claude Code
claude --version

Pas installé ? Pas de panique :

# Installer Node.js via nvm (recommandé)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install --lts

# Installer pnpm
curl -fsSL https://get.pnpm.io/install.sh | sh -
source ~/.bashrc

# Installer Claude Code
npm install -g @anthropic-ai/claude-code

Étape 2.2 : Créer les Dossiers Link to heading

On crée une “maison” pour notre projet :

# Créer les dossiers
mkdir -p ~/mon-assistant-email
mkdir -p ~/.config/gmail-assistant/creds

# Sécuriser (personne d'autre ne peut voir)
chmod 700 ~/.config/gmail-assistant

Étape 2.3 : Ranger le Fichier Téléchargé Link to heading

Vous vous souvenez du fichier client_secret_xxx.json ? On le range :

# Le déplacer (ajustez le chemin si besoin)
mv ~/Téléchargements/client_secret_*.json \
   ~/.config/gmail-assistant/creds/credentials.json

# Le protéger (lecture seule pour vous)
chmod 600 ~/.config/gmail-assistant/creds/credentials.json

# Vérifier
ls -la ~/.config/gmail-assistant/creds/
# Vous devriez voir : -rw------- credentials.json

Étape 2.4 : Créer le Code du Serveur Link to heading

On va créer un petit programme qui fait le pont entre Claude et Gmail.

cd ~/mon-assistant-email

# Créer le fichier de configuration
cat > package.json << 'EOF'
{
  "name": "assistant-email",
  "version": "1.0.0",
  "type": "module",
  "dependencies": {
    "googleapis": "^140.0.0",
    "@modelcontextprotocol/sdk": "^0.5.0"
  }
}
EOF

# Installer les dépendances
pnpm install

Créer le serveur (copier-coller tout ce bloc) :

cat > server.js << 'EOFSRV'
#!/usr/bin/env node
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { google } from 'googleapis';
import { readFile, writeFile } from 'fs/promises';
import { join } from 'path';
import { homedir } from 'os';

// LECTURE SEULE - C'est notre garantie sécurité !
const SCOPES = ['https://www.googleapis.com/auth/gmail.readonly'];
const TOKEN_PATH = join(homedir(), '.config/gmail-assistant/creds/token.json');
const CREDENTIALS_PATH = join(homedir(), '.config/gmail-assistant/creds/credentials.json');

class AssistantEmail {
  constructor() {
    this.server = new Server(
      { name: 'assistant-email', version: '1.0.0' },
      { capabilities: { tools: {} } }
    );
    this.setupTools();
    this.gmail = null;
  }

  async authorize() {
    const credentials = JSON.parse(await readFile(CREDENTIALS_PATH));
    const { client_secret, client_id, redirect_uris } = credentials.installed;
    const oAuth2Client = new google.auth.OAuth2(client_id, client_secret, redirect_uris[0]);

    try {
      const token = await readFile(TOKEN_PATH);
      oAuth2Client.setCredentials(JSON.parse(token));
    } catch (err) {
      return await this.getNewToken(oAuth2Client);
    }
    return oAuth2Client;
  }

  async getNewToken(oAuth2Client) {
    const authUrl = oAuth2Client.generateAuthUrl({
      access_type: 'offline',
      scope: SCOPES,
    });

    console.error('\n🔐 Première connexion - Autorisation nécessaire\n');
    console.error('1. Ouvrez cette URL dans votre navigateur :');
    console.error(`   ${authUrl}\n`);
    console.error('2. Connectez-vous et autorisez');
    console.error('3. Copiez le code que vous recevez\n');
    console.error('Entrez le code ici : ');

    const readline = await import('readline');
    const rl = readline.createInterface({
      input: process.stdin,
      output: process.stderr,
    });

    return new Promise((resolve, reject) => {
      rl.question('', async (code) => {
        rl.close();
        try {
          const { tokens } = await oAuth2Client.getToken(code);
          oAuth2Client.setCredentials(tokens);
          await writeFile(TOKEN_PATH, JSON.stringify(tokens));
          console.error('\n✅ Parfait ! Vous êtes connecté.\n');
          resolve(oAuth2Client);
        } catch (err) {
          console.error('\n❌ Oups, erreur :', err.message);
          reject(err);
        }
      });
    });
  }

  setupTools() {
    this.server.setRequestHandler('tools/list', async () => ({
      tools: [
        {
          name: 'lister_emails',
          description: 'Liste vos emails Gmail',
          inputSchema: {
            type: 'object',
            properties: {
              nombre: { type: 'number', description: 'Nombre d\'emails (max 100)', default: 10 },
              recherche: { type: 'string', description: 'Recherche Gmail (ex: "is:unread")' },
            },
          },
        },
        {
          name: 'chercher_emails',
          description: 'Recherche des emails spécifiques',
          inputSchema: {
            type: 'object',
            properties: {
              recherche: { type: 'string', description: 'Votre recherche' },
              nombre: { type: 'number', default: 10 },
            },
            required: ['recherche'],
          },
        },
      ],
    }));

    this.server.setRequestHandler('tools/call', async (request) => {
      if (!this.gmail) {
        const auth = await this.authorize();
        this.gmail = google.gmail({ version: 'v1', auth });
      }

      const args = request.params.arguments;
      const maxResults = Math.min(args.nombre || args.maxResults || 10, 100);
      const query = args.recherche || args.query || '';

      const res = await this.gmail.users.messages.list({
        userId: 'me',
        maxResults,
        q: query,
      });

      const messages = res.data.messages || [];
      const details = await Promise.all(
        messages.map(async (msg) => {
          const detail = await this.gmail.users.messages.get({
            userId: 'me',
            id: msg.id,
            format: 'metadata',
            metadataHeaders: ['From', 'Subject', 'Date'],
          });

          const headers = detail.data.payload.headers;
          return {
            id: msg.id,
            de: headers.find((h) => h.name === 'From')?.value,
            sujet: headers.find((h) => h.name === 'Subject')?.value,
            date: headers.find((h) => h.name === 'Date')?.value,
          };
        })
      );

      return {
        content: [{ type: 'text', text: JSON.stringify(details, null, 2) }],
      };
    });
  }

  async run() {
    const transport = new StdioServerTransport();
    await this.server.connect(transport);
    console.error('🚀 Assistant Email prêt (lecture seule)\n');
  }
}

const assistant = new AssistantEmail();
assistant.run().catch(console.error);
EOFSRV

# Rendre exécutable
chmod +x server.js

🔗 Partie 3 : Connecter à Claude (5 minutes) Link to heading

Étape 3.1 : Une Seule Commande ! Link to heading

C’est la partie la plus simple. Une seule ligne de commande :

claude mcp add gmail /usr/bin/node ~/mon-assistant-email/server.js

Vérifier que ça a marché :

claude mcp list

# Vous devriez voir :
# gmail: /usr/bin/node /home/[vous]/mon-assistant-email/server.js

Étape 3.2 : Première Connexion Link to heading

Lancer Claude :

claude

Ce qui va se passer :

Un message s’affiche avec une longue URL
Vous copiez cette URL
Vous l’ouvrez dans votre navigateur
Vous vous connectez à Gmail
Google vous dit : “Attention, application non vérifiée”
- Cliquez “Paramètres avancés”
- Cliquez “Accéder à [votre app] (non sécurisé)”
Google montre : “Afficher vos e-mails” ✅ (c’est bien LECTURE SEULE)
Cliquez “Autoriser”
Google vous donne un code
Vous le copiez
Vous le collez dans le terminal Claude
Appuyez sur Entrée

Message de succès :

✅ Parfait ! Vous êtes connecté.
🚀 Assistant Email prêt (lecture seule)

🎮 Partie 4 : Utiliser Votre Assistant (La Partie Fun !) Link to heading

Premier Test : Liste Simple Link to heading

Dans Claude, tapez simplement :

Liste mes 5 derniers emails

Résultat : Claude vous montre vos 5 derniers emails avec expéditeur et sujet !

Exemples Pratiques Link to heading

📧 Retrouver un Email Link to heading

Trouve l'email de Marie de la semaine dernière

📊 Résumé Quotidien Link to heading

Résume-moi les emails importants d'aujourd'hui

🔍 Recherche Avancée Link to heading

Cherche tous les emails non lus qui contiennent "facture"

📅 Organisation Link to heading

Liste les emails de cette semaine, groupés par expéditeur

🚨 Détection Simple Link to heading

Y a-t-il des emails suspects reçus aujourd'hui ?

Prompts Plus Avancés Link to heading

Une fois à l’aise, essayez :

Analyse mes 20 derniers emails et dis-moi :
1. Lesquels nécessitent une réponse urgente
2. Lesquels sont des newsletters
3. Lesquels contiennent des pièces jointes

Fais un petit résumé pour chaque catégorie.

Ou encore :

Parmi mes emails de cette semaine :
- Trouve ceux qui parlent de réunions
- Extrais les dates et heures mentionnées
- Fais-moi un planning

Format : liste claire et simple

🛡️ Sécurité : Ce Que Vous Devez Savoir Link to heading

✅ Ce Que Claude PEUT Faire Link to heading

Lire vos emails
Chercher dans votre boîte
Analyser le contenu
Vous faire des résumés

❌ Ce Que Claude NE PEUT PAS Faire Link to heading

Envoyer des emails ❌
Supprimer des emails ❌
Modifier des emails ❌
Transférer des emails ❌
Créer des brouillons ❌

Pourquoi ? Parce qu’on a configuré gmail.readonly - lecture seule !

🔓 Révoquer l’Accès (Si Besoin) Link to heading

Vous voulez couper l’accès ? 2 clics :

Aller sur : myaccount.google.com/permissions
Trouver “Mon Assistant Email”
Cliquer “Supprimer l’accès”

⚡ Effet immédiat - Claude ne peut plus lire vos emails.

📊 Voir Ce Qui Se Passe Link to heading

Google vous montre tout :

Quand Claude accède à vos emails
Combien de fois
Quel type d’accès (toujours “lecture”)

Allez voir sur : console.cloud.google.com → APIs & Services → Dashboard

🎓 Cas d’Usage Pratiques Link to heading

1. Productivité Quotidienne Link to heading

Le matin :

Résume les emails importants reçus cette nuit

Fin de journée :

Quels emails attendent encore une réponse ?

2. Organisation Link to heading

Trouve tous les emails de mon boss ce mois-ci et 
résume les points d'action demandés

3. Recherche Historique Link to heading

En 2024, combien d'emails j'ai reçus de [entreprise] ?
Quel était le sujet principal ?

4. Nettoyage Link to heading

Liste toutes les newsletters que je reçois régulièrement.
Montre-moi celles que je n'ouvre jamais.

5. Analyse Simple Link to heading

Parmi mes 50 derniers emails, lesquels ont l'air bizarres ou suspects ?
Explique pourquoi pour chacun.

🔧 Dépannage

Problème : Claude ne voit pas Gmail Link to heading

Solution :

# Vérifier la config
claude mcp list

# Si vide, refaire :
claude mcp add gmail /usr/bin/node ~/mon-assistant-email/server.js

Problème : “Token expiré” Link to heading

Solution :

# Supprimer le token
rm ~/.config/gmail-assistant/creds/token.json

# Relancer Claude
claude
# Le processus d'autorisation recommence

Problème : “Permission denied” Link to heading

Solution :

# Vérifier les permissions
chmod 600 ~/.config/gmail-assistant/creds/credentials.json
chmod +x ~/mon-assistant-email/server.js

💡 Conseils et Astuces Link to heading

Rendre Claude Plus Efficace Link to heading

Soyez précis :

❌ “Trouve mes emails”
✅ “Trouve les emails de cette semaine avec ‘projet’ dans le sujet”

Demandez des formats :

Liste mes emails en format tableau avec :
- Date
- Expéditeur
- Sujet court

Itérez :

Première demande : "Liste mes emails d'aujourd'hui"
Affinage : "Maintenant, montre seulement ceux du client X"

Créer des Routines Link to heading

Routine du matin :

Fais-moi mon briefing email du jour :
1. Nombre total de nouveaux emails
2. Top 3 des plus importants
3. Ceux qui nécessitent une réponse rapide
4. Newsletters à lire plus tard

Format : concis et actionnable

Routine du vendredi :

Résumé de la semaine :
- Quels sujets sont revenus souvent ?
- Qui m'a le plus écrit ?
- Y a-t-il des emails sans réponse ?

✅ Checklist Finale Link to heading

Vous avez réussi si :

Projet créé sur Google Cloud
Gmail API activée
OAuth configuré (lecture seule uniquement)
Credentials téléchargés et sécurisés
Serveur MCP installé
Claude connecté (claude mcp list fonctionne)
Premier test réussi (liste d’emails)
Vous savez révoquer l’accès si besoin

🎉 Félicitations ! Link to heading

Vous avez créé votre propre assistant d’analyse d’emails avec l’IA !

Vous savez maintenant :

✅ Configurer l’API Gmail en lecture seule
✅ Connecter Claude Code à vos emails
✅ Analyser vos emails avec l’intelligence artificielle
✅ Contrôler l’accès et la sécurité

Prochaines étapes :

Expérimentez avec différents prompts
Créez vos propres routines
Partagez vos découvertes

Besoin d’aide ?

Documentation Claude : docs.claude.com
Gmail API : developers.google.com/gmail
Communauté : Reddit r/ClaudeAI

Auteur : Xavier GUERET & claude Date : 18 janvier 2025 Licence : MIT

Tags : #tutoriel #claude-code #gmail #ia #automatisation #débutant

Ce tutoriel vous montre comment accéder à vos propres données Gmail de manière sécurisée. Respectez toujours la vie privée des autres et les conditions d’utilisation des services.

🎯 Ce Que Vous Allez Créer Link to heading

Pourquoi ce tutoriel ? Link to heading

Ce dont vous avez besoin Link to heading

🚀 Vue d’Ensemble : Comment Ça Marche ? Link to heading

📋 Partie 1 : Préparer Google Cloud (15 minutes) Link to heading

Étape 1.1 : Créer Votre Projet Link to heading

Étape 1.2 : Activer l’API Gmail Link to heading

Étape 1.3 : Configurer les Permissions (Important !) Link to heading

Étape 1.4 : Télécharger Votre “Clé” Link to heading

💻 Partie 2 : Installation sur Votre Ordinateur (10 minutes) Link to heading

Étape 2.1 : Vérifier les Prérequis Link to heading

Étape 2.2 : Créer les Dossiers Link to heading

Étape 2.3 : Ranger le Fichier Téléchargé Link to heading

Étape 2.4 : Créer le Code du Serveur Link to heading

🔗 Partie 3 : Connecter à Claude (5 minutes) Link to heading

Étape 3.1 : Une Seule Commande ! Link to heading

Étape 3.2 : Première Connexion Link to heading

🎮 Partie 4 : Utiliser Votre Assistant (La Partie Fun !) Link to heading

Premier Test : Liste Simple Link to heading

Exemples Pratiques Link to heading

📧 Retrouver un Email Link to heading

📊 Résumé Quotidien Link to heading

🔍 Recherche Avancée Link to heading

📅 Organisation Link to heading

🚨 Détection Simple Link to heading

Prompts Plus Avancés Link to heading

🛡️ Sécurité : Ce Que Vous Devez Savoir Link to heading

✅ Ce Que Claude PEUT Faire Link to heading

❌ Ce Que Claude NE PEUT PAS Faire Link to heading

🔓 Révoquer l’Accès (Si Besoin) Link to heading

📊 Voir Ce Qui Se Passe Link to heading

🎓 Cas d’Usage Pratiques Link to heading

1. Productivité Quotidienne Link to heading

2. Organisation Link to heading

3. Recherche Historique Link to heading

4. Nettoyage Link to heading

5. Analyse Simple Link to heading

Problème : Claude ne voit pas Gmail Link to heading

Problème : “Token expiré” Link to heading

Problème : “Permission denied” Link to heading

💡 Conseils et Astuces Link to heading

Rendre Claude Plus Efficace Link to heading

Créer des Routines Link to heading

✅ Checklist Finale Link to heading

🎉 Félicitations ! Link to heading

Assistant Virtual