SERVEUR MCP · API GMAIL OFFICIELLE · LOCAL

Gmail pour vos IA.
Envoi sur accord.

Gmail for AI agents that is safe to leave alone.

Un serveur MCP local, nexus-agymail, donne votre Gmail à Antigravity (dont la boutique n’a pas de connecteur Gmail) ou à tout client MCP, par l’API Gmail officielle : recherche, lecture, pièces jointes, brouillons, libellés, corbeille réversible, et envoi d’un brouillon seulement après votre oui pour ce brouillon exact. Rien n’est jamais supprimé pour de bon.

Installer Explorer le code

Les mêmes outils que le MCP Gmail de Google
Envoi lié au brouillon exact
Jamais de suppression définitive

Compatible avec

Une enveloppe et un brouillon en attente de votre accord, avec son jeton à usage unique, relié à Antigravity — Illustration d’un échange : l’agent écrit un brouillon, ne peut l’envoyer qu’avec votre accord sur ce brouillon exact, et ne peut rien supprimer pour de bon.

MCPGMAIL API V1OAUTHPYTHON 3.14DPAPIMIT

01 / CE QUE ÇA FAIT

Les outils officiels.
Sur votre machine.

Mêmes noms et mêmes paramètres que le serveur MCP Gmail officiel de Google, sans programme de préversion ni point d’accès distant, plus trois outils propres.

search_threads
Cherche des fils (syntaxe Gmail), une page par appel, avec le résumé des derniers messages.
get_message, get_thread
Un message ou un fil, corps en texte, citations des réponses précédentes retirées.
download_attachment
Enregistre une pièce jointe sous un nom nettoyé, sans jamais écraser, marquée comme venant d’Internet.
create_draft, update_draft
Brouillons, réponses dans le même fil, pièces jointes jointes par chemin.
label_*, unlabel_*
Libellés et archivage, par message ou par fil, 100 éléments au plus.
trash_*, untrash_*
Corbeille, réversible pendant 30 jours.
send_draft
Envoie seulement avec votre accord sur ce brouillon exact, relu juste avant l’envoi.
auth_status
Où est le jeton, quelles portées il porte, s’il faut se reconnecter.

02 / INSTALLATION

Dix minutes.
Une seule fois.

Prérequis
- Windows, macOS ou Linux
- Un compte Google, environ 10 minutes, une fois
Installer uv
S’il n’est pas déjà là : ouvrez PowerShell et collez :
irm https://astral.sh/uv/install.ps1 | iex
macOS, Linux :
curl -LsSf https://astral.sh/uv/install.sh | sh
Créer votre propre accès Google
Votre courrier ne passe par l’application de personne d’autre.
- Ouvrez la Google Cloud Console et créez un projet (nom libre) ;
- Activez l’API Gmail ;
- Google Auth Platform > Branding : nom de l’appli et votre adresse. Audience : Externe, ajoutez votre adresse Gmail comme utilisateur test, puis Publier l’application (sinon Google vous redemande la connexion tous les 7 jours) ;
- Clients : Créer un client, type Application de bureau, Télécharger le JSON.
Connecter votre Gmail
Votre navigateur s’ouvre sur la page de Google :
uvx --python 3.14 nexus-agymail auth --client-secret "$HOME\Downloads\client_secret_XXXX.json"
Google affiche « Google n’a pas validé cette application » : c’est la vôtre, cliquez Paramètres avancés, Accéder à … (non sécurisé), puis autorisez.
Brancher Antigravity, puis le redémarrer
uvx --python 3.14 nexus-agymail setup
Une autre IA (Claude Desktop, Cursor, VS Code, Codex) : ajoutez le serveur uvx --python 3.14 nexus-agymail dans sa configuration MCP (exemples dans le README).
Essayer
Demandez par exemple : « Résume mes mails non lus de la semaine », « Archive les newsletters de plus d’un mois », « Prépare une réponse à Alice pour dire que je suis d’accord et montre-la-moi avant d’envoyer ».

Pour vérifier :

uvx --python 3.14 nexus-agymail status

Pour tout retirer : supprimez ~\.nexus\nexus-agymail et ~\.gemini\config\plugins\nexus-agymail, puis retirez l’accès dans votre compte Google.

Code, documentation et installeur : dépôt GitHub de NexusAGYmail.

Projet indépendant, non affilié à Google ; Gmail est une marque de Google LLC.

Version: 0.8.0
Licence: MIT
Système: Windows (usage quotidien), Linux (tests en CI) ; macOS non éprouvé
Clients: Antigravity, et tout client MCP (Claude Desktop, Codex, Cursor, VS Code)
Portées: gmail.readonly, gmail.compose, gmail.modify

03 / ÉCOSYSTÈME NEXUS

Seul, il marche.
Ensemble, il en fait plus.

NexusAGYmail s’installe seul, ou avec les autres briques Nexus. Chacune enrichit les autres, et chacune a sa sortie de secours : si une brique manque, rien ne casse.

NexusBrowser

AvecPour les réglages de Gmail (filtres, signature) ou un autre compte Google, l’agent passe par votre vrai Chrome.

SansCes réglages se font à la main dans Gmail.

Découvrir NexusBrowser

NexusRelay

AvecClaude peut confier un tri ou une réponse à Antigravity, qui s’en charge avec ses outils.

SansChaque IA travaille seule.

Découvrir NexusRelay

NexusWindows

AvecUne pièce jointe enregistrée peut ensuite être ouverte et traitée dans une appli de bureau.

SansNexusAGYmail n’en dépend pas.

Découvrir NexusWindows

NexusAndroid

AvecLes agents pilotent aussi un vrai téléphone Android.

SansNexusAGYmail n’en dépend pas.

Découvrir NexusAndroid

04 / SÉCURITÉ

Tenue par le code.
Pas par une consigne.

Un mail ne peut jamais déclencher un envoi, chaque mail est présenté comme une donnée, et les secrets ne sont jamais joints.

Jamais de suppression définitive

Portées gmail.readonly, gmail.compose et gmail.modify ; jamais la seule portée qui permet de supprimer pour de bon, et aucun outil pour le faire.

Envoi lié au brouillon exact

Un jeton à usage unique (10 minutes) lié aux destinataires, à l’objet, au corps et à l’empreinte de chaque pièce jointe ; le brouillon est relu juste avant l’envoi, et rien ne part s’il a changé.

Provenance des destinataires

Un destinataire trouvé dans un mail lu par l’agent est signalé dans le résumé : permis seulement si vous l’avez demandé.

Mails encadrés comme données

Objet, corps, adresses et noms de pièces jointes sont rendus encadrés et étiquetés comme données ; un mail qui ressemble à des consignes pour une IA est signalé.

Pièces jointes durcies

Noms nettoyés, jamais d’écrasement, marque « téléchargé depuis Internet » ; jamais de pièce jointe prise dans un dossier de secrets.

Jeton chiffré

Chiffré par DPAPI pour votre compte Windows (un fichier lisible par vous seul ailleurs), écrit de façon atomique, jamais affiché.

Confidentialité

Ni compte, ni télémétrie, ni relais : les seules requêtes vont à Google, avec votre propre client OAuth. Aucun mail n’est écrit sur le disque, sauf une pièce jointe que vous demandez.

05 / À SAVOIR

Honnête.
Limites comprises.

Votre propre client OAuth

Chaque utilisateur crée son client Google : un client public partagé demanderait la vérification des portées restreintes par Google et un audit de sécurité.

Texte brut à l’écriture

Les brouillons s’écrivent en texte ; pas de réglages Gmail (filtres, signature, transferts), à faire dans Gmail.

Pas de spam, exprès

Ni signalement de spam ni suppression définitive. Utilisé chaque jour sous Windows 11 ; macOS non éprouvé.

06 / LIENS

Lisez le code.
Gardez la main sur vos mails.

Le serveur, les tests contre une fausse API Gmail et la documentation sont sur GitHub, sous licence MIT.

Ouvrir le dépôt GitHub

Gmail pour vos IA.Envoi sur accord.

Les outils officiels.Sur votre machine.

Dix minutes.Une seule fois.

Prérequis

Installer uv

Créer votre propre accès Google

Connecter votre Gmail

Brancher Antigravity, puis le redémarrer

Essayer

Seul, il marche.Ensemble, il en fait plus.