MIS À JOUR LE 7 SEPTEMBRE 2026

Installer et vérifier ton agent mail

Commence sur une boîte de test avant de confier tes échanges clients au kit.

Ce que le kit fait réellement

Le script run.sh applique des libellés, puis appelle Claude Code pour le tri et la préparation de brouillons. Il modifie donc Gmail : ce n’est pas un simple lecteur local. Le helper comporte aussi une fonction d’archivage. Le mode brouillon est une consigne de fonctionnement, pas une garantie que tous les outils sont limités à la lecture.

Le contenu fourni à Claude peut être traité par le fournisseur du modèle. N’utilise pas ce kit en pensant que tes emails restent exclusivement sur ton ordinateur. Commence sur une boîte de test contenant des messages fictifs.

1. Vérifie les prérequis

git --version
python3 --version
claude --version

Il te faut Git, Python 3 et un accès Claude Code compatible. Le coût dépend de cet accès ; ce kit n’inclut pas un abonnement. Si une commande manque, installe le prérequis depuis sa documentation avant de continuer.

2. Récupère et prépare le kit

git clone https://github.com/martinoh-ai/mail-agent-kit.git
cd mail-agent-kit
./setup.sh

Le setup crée .env et preferences.md s’ils manquent et contrôle certains prérequis. Lis run.sh et triage.md avant la première exécution pour comprendre les actions autorisées.

Code et README du kit

3. Configure le compte de test

Ce kit utilise un mot de passe d’application Gmail. Google exige la validation en deux étapes et certains comptes ne proposent pas cette option. Google recommande la connexion Google lorsque l’application la prend en charge ; le kit consulté utilise IMAP avec un mot de passe.

Aide Google : mots de passe d’application

Renseigne toi-même .env dans ton éditeur local. Ne colle pas le secret dans une conversation IA. Un mot de passe d’application est réutilisable jusqu’à révocation : ce n’est pas un code à usage unique.

GMAIL_USER=adresse-de-test@gmail.com
GMAIL_APP_PASSWORD=REMPLACER_LOCALEMENT

chmod 600 .env

Adapte preferences.md : ce qui mérite une réponse, tes expéditeurs importants et deux exemples de ton. N’ajoute pas de données inutiles.

4. Vérifie la connexion avant les écritures

python3 gmail_helper.py list --max 5 --query "newer_than:1d"

Cette commande liste un petit échantillon. Garde sa sortie privée. Si elle échoue, corrige l’authentification avant de lancer le tri complet. Le script run.sh ne propose pas de simulation globale : ne confonds pas cette vérification avec son exécution.

5. Lance le tri sur la boîte de test

./run.sh

Ce lancement applique les libellés puis prépare des brouillons. Vérifie les messages automatiques, les vrais échanges, les mauvaises classifications et les éventuels doublons après un second passage. Contrôle que rien ne part vers un destinataire. Ne passe à ta boîte principale qu’après revue des accès et du comportement.

6. Automatise seulement après validation

Le kit ne devient pas récurrent par sa seule installation. Un planificateur doit disposer du bon dossier, de Python, de Claude et des accès nécessaires. Vérifie la sortie du premier lancement planifié et l’endroit où lire ses erreurs ; sur un Mac local, la disponibilité de la machine compte.

Avant de programmer, écris comment suspendre la tâche. Pour retirer l’accès Gmail, révoque le mot de passe d’application dans ton compte Google. Ne partage pas les sorties ou journaux contenant des emails réels.

Ton critère de réussite

Des libellés pertinents, des brouillons que tu as envie de reprendre et moins de temps de correction que de tri manuel. Mesure ce résultat sur plusieurs jours. Une promesse d’installation en dix minutes ou de rentabilité en une semaine ne le remplace pas.