Communitygithub.com

Gestion de la boîte de réception Gmail

Gérez les e-mails sur plusieurs comptes Gmail avec des outils unifiés. Utilisez cette compétence lorsque l'utilisateur demande de vérifier ses e-mails, lire sa boîte de réception, étiqueter, archiver ou gérer Gmail.

Qu'est-ce que Gestion de la boîte de réception Gmail ?

Cette compétence d'agent IA offre une gestion unifiée des e-mails sur plusieurs comptes Gmail. Elle est idéale pour les développeurs et professionnels qui utilisent plusieurs adresses Gmail (personnelle, entreprise) et souhaitent les administrer depuis un seul point d'entrée en ligne de commande. La compétence s'appuie sur des scripts Python (`gmail_unified.py`, `gmail_multi_auth.py`, `gmail_bulk_label.py`, `gmail_create_filters.py`) qui interagissent avec l'API Gmail. Elle permet de consulter les e-mails non lus, de les étiqueter, de les archiver, de les marquer comme lus et de créer des filtres, le tout avec la possibilité de cibler un compte spécifique via le paramètre `--account`. La configuration se fait via un registre de comptes et des fichiers d'identifiants OAuth (credentials.json, token_*.json). La compétence est gratuite (API Gmail) et fonctionne sur tout système d'exploitation supportant Python. Elle est conçue pour être utilisée avec des agents comme Claude Code, Cursor ou Codex, et peut être chaînée avec d'autres compétences comme `gmail-label` ou `instantly-autoreply`.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aiagentwithdhruv/skills/tree/HEAD/gmail-inbox

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Gestion de la boîte de réception Gmail ?

Objectif

Vérifier et gérer les e-mails sur plusieurs comptes Gmail à l'aide d'outils unifiés.

Scripts

  • ./scripts/gmail_unified.py - Vérifier et gérer les boîtes de réception
  • ./scripts/gmail_multi_auth.py - Authentifier les comptes
  • ./scripts/gmail_bulk_label.py - Étiquetage en masse
  • ./scripts/gmail_create_filters.py - Créer des filtres
  • ./scripts/gmail_auth.py - Aide à l'authentification

Référence rapide

# Vérifier les e-mails non lus sur tous les comptes
python3 ./scripts/gmail_unified.py --query "is:unread" --limit 50

# Vérifier un compte spécifique uniquement
python3 ./scripts/gmail_unified.py --query "is:unread" --account yourcompany

# Lister les comptes enregistrés
python3 ./scripts/gmail_unified.py --accounts

# Étiqueter et archiver les e-mails
python3 ./scripts/gmail_unified.py --query "from:notifications@" --label "Notifications" --archive

# Marquer comme lu
python3 ./scripts/gmail_unified.py --query "from:noreply@" --mark-read

# Test à blanc (aperçu)
python3 ./scripts/gmail_unified.py --query "subject:facture" --label "Factures" --dry-run

Registre des comptes

CompteE-mailIdentifiantsJeton
youruser[email protected]credentials.jsontoken_youruser.json
yourcompany[email protected]credentials_yourcompany.jsontoken_yourcompany.json

Dépannage des erreurs d'authentification

"Fichier de jeton introuvable"

python3 ./scripts/gmail_multi_auth.py --account yourcompany --email [email protected]

"invalid_scope: Bad Request"

rm token_youruser.json
python3 ./scripts/gmail_multi_auth.py --account youruser --email [email protected]

"Échec de l'authentification" Vérifiez que le fichier credentials.json existe dans le répertoire racine.

Étendues requises

  • gmail.modify - Lecture/écriture des e-mails
  • gmail.labels - Créer/gérer les libellés
  • gmail.settings.basic - Gérer les paramètres
  • spreadsheets - Accès à Google Sheets
  • drive - Accès à Google Drive

Emplacement des identifiants

Tous les fichiers d'identifiants doivent se trouver dans la racine de l'espace de travail :

  • credentials.json / credentials_yourcompany.json - Configurations du client OAuth
  • token_*.json - Jetons d'authentification (générés automatiquement)
  • gmail_accounts.json - Registre des comptes

Schéma

Entrées

NomTypeRequisDescription
querystringNonRequête de recherche Gmail (par exemple 'is:unread')
accountstringNonNom du compte spécifique dans le registre
limitintegerNonNombre maximum d'e-mails à récupérer (défaut : 50)

Sorties

NomTypeDescription
emailsarrayListe d'objets e-mail avec sujet, expéditeur, date, extrait

Identifiants

NomSource
credentials.jsonfichier
token_*.jsonfichier (généré automatiquement)

Composable avec

Compétences qui s'enchaînent bien avec celle-ci : gmail-label, instantly-autoreply

Coût

Gratuit (API Gmail)

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

aiagentwithdhruv/skills

Add new Modal webhooks for event-driven execution. Use when user asks to create a webhook, add an endpoint, or set up event triggers.

aiagentwithdhruv/skills

Answer Euron Gen AI Bootcamp doubts instantly. Covers Euri API setup across all frameworks (Python, LangChain, OpenAI SDK, TypeScript, n8n, curl), MCP server setup, common errors, model recommendations, and token limits. Use when someone in the bootcamp asks a question.

aiagentwithdhruv/skills

Auto-label Gmail emails into Action Required, Waiting On, and Reference categories. Use when user asks to label emails, triage inbox, categorize emails, or organize Gmail.

aiagentwithdhruv/skills

Scrape Google Maps for B2B leads with deep website enrichment and contact extraction. Use when user asks to find local businesses, scrape Google Maps, generate contractor lists, or build local service business databases.

aiagentwithdhruv/skills

Run Claude orchestrator locally with Cloudflare tunneling. Use when user asks to run locally, start local server, or test webhooks locally.

aiagentwithdhruv/skills

MCP server for AI-powered macOS control — apps, display, audio, files, screenshots, clipboard

aiagentwithdhruv/skills

Deploy execution scripts to Modal cloud. Use when user asks to deploy to Modal, push code to cloud, or update Modal functions.

aiagentwithdhruv/skills

Scrape and verify business leads using Apify, classify with LLM, enrich emails, and save to Google Sheets. Use when user asks to find leads, scrape businesses, generate prospect lists, or build lead databases for any industry or location.

aiagentwithdhruv/skills

Query Skool community content using RAG pipeline with vector search. Use when user asks to search Skool knowledge, find community answers, or query Skool content.

aiagentwithdhruv/skills

Scrape Upwork jobs and generate personalized proposals with cover letters. Use when user asks to find Upwork jobs, create Upwork proposals, or apply to Upwork listings.

Skills associés