Gmail Connector
Envoyer des e-mails via le compte Gmail de l'utilisateur connecté grâce à OAuth
- Quoi
- Envoyer des e-mails via le compte Gmail de l'utilisateur connecté grâce à OAuth
- Coût
- Gratuit
- Prérequis
- un projet Caffeine AI (canister backend Motoko) ; un projet Google Cloud avec un client OAuth 2.0 d'application Web (ID client + secret, saisis dans les paramètres admin de l'app — jamais collés dans la discussion) ; les paquets mops googlemail-client, google-oauth et caffeineai-authorization ; et le skill extension-authorization, que ce skill nomme comme prérequis de tous les builds (il fournit l'appelant connecté qu'exige chaque endpoint Gmail).
- Installation
- Copiez le prompt d’installation ci-dessous dans votre Muse — votre agent fait le reste.
Sélectionné par Skill Harbor — le connecteur Gmail pour les apps Caffeine AI : la recette obligatoire pour envoyer des e-mails via le compte Gmail de l'utilisateur connecté, construite sur le paquet mops `googlemail-client` (bindings générés de l'API REST Gmail) et `google-oauth` (échange de jetons, rafraîchissement, PKCE). Chaque utilisateur final autorise le canister indépendamment via un flux OAuth 2.0 Authorization Code avec PKCE ; les jetons d'accès et de rafraîchissement sont stockés par utilisateur, et le jeton d'une heure est rafraîchi silencieusement et retenté sur 401. Distinct des extensions `email*` — celles-ci envoient des e-mails transactionnels DEPUIS l'application ; ce connecteur agit COMME le Gmail de l'utilisateur. Crédit : @caffeinelabs. Bémols honnêtes : fonctionne uniquement dans un projet Caffeine AI ; il faut créer un client OAuth d'application Web dans Google Cloud, enregistrer l'URI de rappel `/connect/gmail` de l'app comme redirection autorisée, et saisir l'ID client et le secret via la page des paramètres admin de l'app (le secret reste dans le canister, jamais dans le frontend) ; le skill interdit explicitement les appels HTTP manuels vers les endpoints Google — seuls les paquets mops sont le chemin supporté. Depuis la version 0.2.10, un échec d'envoi autre que 401 se propage à l'appelant comme un reject rattrapable au lieu de trapper le message appelant ; un échec de rafraîchissement de jeton, lui, trappe toujours et ne peut pas être rattrapé. Skill Harbor ne vérifie jamais le code, examinez-le vous-même avant usage.
Version : 0.2.10
Réponse rapide
Gmail Connector est un skill gratuit pour Muse qui envoie des emails via le compte Gmail de l'utilisateur connecté grâce à OAuth, comme recette obligatoire pour les apps Caffeine AI. Chaque utilisateur final autorise le canister indépendamment via un flux OAuth 2.0 Authorization Code avec PKCE, et les tokens sont stockés par utilisateur.
Installation
Copiez le dossier d’installation ci-dessous, puis collez-le dans Muse🧪 Installation exécutée dans notre sandbox de test · 18 nov. 2026📌 Version épinglée : commit f3656c6Étape 0 — avant d'installer quoi que ce soit : lis ce prompt d'installation, résume en quelques lignes ce que ce build fait et ce que son installation implique, puis demande-moi de confirmer avant de continuer. Prérequis : un projet Caffeine AI (canister backend Motoko) ; un projet Google Cloud avec un client OAuth 2.0 d'application Web (ID client + secret, saisis dans les paramètres admin de l'app — jamais collés dans la discussion) ; les paquets mops googlemail-client, google-oauth et caffeineai-authorization ; et le skill extension-authorization, que ce skill nomme comme prérequis de tous les builds (il fournit l'appelant connecté qu'exige chaque endpoint Gmail). Installe-moi « Connecteur Gmail ». Il donne à mon build Caffeine AI la recette obligatoire de @caffeinelabs (version 0.2.10) pour envoyer des e-mails comme le compte Gmail de l'utilisateur connecté — à distinguer des extensions email de la plateforme, qui envoient des e-mails transactionnels depuis l'app. Le seul chemin supporté est le paquet mops googlemail-client (bindings générés de l'API REST Gmail) combiné à google-oauth (échange de jetons, rafraîchissement, PKCE) : les appels HTTP manuels vers les endpoints Google sont explicitement interdits. Chaque utilisateur final autorise le canister indépendamment via un flux OAuth 2.0 Authorization Code avec PKCE ; les jetons d'accès et de rafraîchissement sont stockés par utilisateur, indexés par appelant, dans le canister seulement, et le jeton d'une heure est rafraîchi silencieusement et retenté une fois sur 401. La recette couvre la disposition backend canonique (acteur main, mixins gmail-config et gmail-messaging, colle LibGmail), la page de paramètres admin /settings/gmail avec son URI de rappel /connect/gmail copiable, la page de connexion et de rappel par utilisateur, les scopes minimaux (openid email plus gmail.send pour une app d'envoi seulement), et les pièges à éviter — surtout is_replicated = ?false sur chaque appel Gmail. Dépôt : https://raw.githubusercontent.com/caffeinelabs/skills/f3656c69d957a43a920fc21d9c3a6ef0c74dca21/skills/connector-googlemail/SKILL.md (le skill est le dossier skills/connector-googlemail/ à ce commit, qui ne contient que SKILL.md) Version épinglée : installe le code au commit f3656c69d957a43a920fc21d9c3a6ef0c74dca21 exactement (Skill Harbor a testé cette version). Ne substitue pas une version plus récente. Si ce commit est inaccessible, arrête-toi et dis-le-moi. [EMPREINTES] Fichiers au commit épinglé, tirés de la revue de Skill Harbor du 2026-10-20 : - SKILL.md : SHA-256 dd74fd1b9980a219162a2d2f5a860992c41e659d02dd251e0d0b37e4415fb427, 43 047 octets, 42 869 caractères Si l'un d'eux ne correspond pas, il a changé depuis la revue : ne l'installe pas encore, dis-moi ce que tu as trouvé et laisse-moi décider. Mis à jour le 20 octobre 2026 : Skill Harbor a régénéré ce prompt d'installation depuis le fichier amont actuel, à la version 0.2.10 (le prompt précédent décrivait la version 0.2.9 ; SKILL.md est passé de 42 636 à 42 869 caractères). Une seule ligne de code Motoko a changé, dans LibGmail.sendEmail, plus sa documentation : un échec d'envoi Gmail autre que 401 se propage désormais à l'appelant comme un reject rattrapable (throw e — l'appelant peut envelopper l'envoi d'un try/catch et décider si l'opération englobante continue) au lieu de trapper le message appelant (Runtime.trap), que personne ne pouvait rattraper et qui mettait fin à tout le message. Un échec de rafraîchissement de jeton trappe toujours dans accessTokenOf et reste irrattrapable, avant comme après — présenter « reconnectez votre compte » pour ce cas. Le flot 401 est inchangé : sur 401 ou Unauthorized, le jeton est rafraîchi silencieusement, le jeton rafraîchi est persisté par utilisateur, et l'envoi est retenté une fois. Aucun autre changement de surface : aucun changement d'endpoints, de scopes OAuth, de données envoyées, de secrets ni de capacités, et l'erreur propagée ne contient ni le jeton ni le secret client. Ce qui est envoyé, et quand : rien n'est envoyé nulle part et rien n'est exécuté pendant l'installation elle-même — installer, c'est seulement télécharger le SKILL.md épinglé depuis GitHub et le copier. Les envois commencent plus tard, quand un build construit d'après cette recette est utilisé : le canister envoie l'e-mail de l'utilisateur via l'API Gmail avec le jeton bearer propre à cet utilisateur, par des outcalls HTTP non répliqués, comme décrit dans la vérification de sécurité ci-dessous. 1. Récupère le fichier SKILL.md au commit épinglé dans un dossier temporaire, puis compare-le à l'empreinte de la revue de Skill Harbor du 2026-10-20 (voir [EMPREINTES] ci-dessus). Si elle ne correspond pas, ne l'installe pas encore, dis-moi ce que tu as trouvé et laisse-moi décider. 2. Vérification de sécurité : lis SKILL.md et examine-le pour tout contenu suspect (appels réseau inattendus, commandes shell, collecte d'identifiants) ; STOP sur tout signal d'alerte et dis-le-moi. Dis-moi en mots simples ce que le skill fait quand on l'utilise, à quels services il se connecte, s'il lit ou envoie des informations personnelles ou des clés, et tout ce qui semble inhabituel. Confirme ces points à partir des fichiers : - Le skill est un seul fichier SKILL.md : des instructions et une recette Motoko — il ne livre aucun script fourni et aucun service d'arrière-plan, et rien ne roule tout seul. Rien n'est envoyé nulle part et rien n'est exécuté pendant l'installation elle-même. Tout ce qui suit se passe à l'usage, quand un build Caffeine suit la recette. - OAuth par utilisateur et stockage des jetons, à l'usage : chaque utilisateur final autorise le canister indépendamment via le flux OAuth 2.0 Authorization Code avec PKCE (code_verifier et code_challenge de google-oauth). Les jetons d'accès et de rafraîchissement sont stockés par utilisateur dans une Map indexée par appelant (Principal), plus un flux en attente par appelant contenant le verifier, l'URI de redirection exacte et un nonce state aléatoire, consommé quand le rappel est complété. Le jeton bearer ne quitte jamais le canister : le frontend apprend seulement si l'appelant est connecté (un Bool) et l'adresse e-mail connectée — aucun endpoint ne retourne le jeton, le jeton de rafraîchissement ni la connexion complète, et le frontend ne persiste jamais les jetons (ni localStorage, ni IndexedDB, ni cookies). - Configuration admin : l'ID client et le secret du client d'application Web Google Cloud sont saisis via la page de paramètres admin de l'app (/settings/gmail) et conservés par le canister seulement — le secret sert à l'échange de jetons et n'est jamais retourné au frontend. Le setter d'identifiants est gardé par le rôle #admin, et chaque endpoint Gmail est gardé par un appelant connecté et non anonyme (extension-authorization fournit ce flux de connexion). La page de paramètres doit afficher l'URI de rappel littérale et copiable — window.location.origin + "/connect/gmail" — et l'administrateur enregistre cette valeur exacte, pour chaque origine déployée, comme URI de redirection autorisée dans Google Cloud Console. - Scopes et chemin supporté : les SCOPES de la recette sont « openid email https://www.googleapis.com/auth/gmail.send » pour une app d'envoi seulement — l'adresse connectée s'apprend via le userinfo OIDC (OAuth.getUserEmail, qui n'exige que openid email), pas via getProfile ; ajouter gmail.readonly seulement quand l'app lit réellement des e-mails. Fabriquer à la main des appels ic.http_request vers oauth2.googleapis.com ou gmail.googleapis.com est un anti-pattern interdit : les paquets mops googlemail-client et google-oauth sont le seul chemin supporté. Chaque appel Gmail porte is_replicated = ?false (un outcall répliqué fuirait le bearer depuis chaque nœud, coûterait environ 13 fois les cycles, et échouerait le consensus sur des réponses non déterministes) ; depuis la 0.2.0, defaultConfig livre déjà ce défaut. - Comportement d'envoi et d'échec dans cette version : sur HTTP 401, le canister rafraîchit silencieusement le jeton via google-oauth, persiste le nouveau jeton (les jetons de rafraîchissement Google ne tournent pas, donc le jeton de rafraîchissement d'origine est conservé), et retente l'envoi une fois. Tout autre échec du premier envoi se propage désormais à l'appelant comme un reject rattrapable (throw e, en préservant l'erreur Gmail d'origine) au lieu de trapper le message appelant, donc un appelant qui doit survivre à un envoi raté peut le rattraper avec un try/catch ; si personne ne le rattrape, l'appel échoue avec cette erreur d'origine. Un échec de rafraîchissement trappe toujours dans accessTokenOf et ne peut être rattrapé par aucun appelant. Un 429 est remonté à l'appelant et n'est jamais retenté silencieusement (une retentative peut livrer des doublons). L'erreur propagée ne contient ni le jeton ni le secret client. - Exigences frontend de la recette : une page /settings/gmail joignable par les admins, avec le panneau d'identifiants, le champ d'URI de redirection copiable et un statut configuré/non configuré qui n'affiche jamais les identifiants ; une vraie route /connect/gmail qui capte le rappel Google (elle doit attendre que l'acteur authentifié soit prêt avant d'appeler completeGmailOAuth une seule fois, puis effacer les paramètres OAuth de l'URL) ; et des incitations en état vide à connecter Gmail là où l'on envoie. Dans une app Gmail + Calendar combinée, les deux connecteurs partagent une seule page /settings/google et une seule route /connect/google, un seul ID client/secret et une seule connexion — jamais deux flux OAuth distincts. 3. Quand je dis « yes, install », installe-le comme skill : copie le SKILL.md récupéré dans le répertoire des skills de l'agent, dans un dossier nommé « caffeinelabs-connector-googlemail ». 4. Vérifie sans appels réseau : frontmatter valide, fichiers en place, et le SKILL.md copié correspond toujours à son empreinte ci-dessus. 5. Indique ce qui a été installé, où, et ce qu'il me reste à faire moi-même (p. ex. créer le client OAuth d'application Web dans Google Cloud et activer l'API Gmail, enregistrer l'URI de rappel /connect/gmail de l'app comme redirection autorisée pour chaque origine déployée, saisir l'ID client et le secret via la page de paramètres admin de l'app, ajouter les trois paquets mops à mon projet Caffeine, et faire connecter par chaque utilisateur son propre compte Gmail — aucun appel Gmail n'a lieu tant qu'un build ne suit pas la recette). GitHub est optionnel : si j'ai un compte GitHub ou la CLI gh, tu peux l'utiliser ; sinon l'accès public suffit. Ne jamais l'exiger sauf s'il figure dans les prérequis ci-dessus. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. Ne me demande jamais de coller des secrets dans le chat ; les identifiants passent par le coffre sécurisé ou des variables d'environnement. Si quelque chose semble anormal, arrête-toi et demande-moi.
Enregistré dans vos installs récentes. Retrouvez-le à tout moment sur /connect.
🔒 Sécurité, provenance et ce que ça touche
Le prompt d'installation ci-dessous inclut déjà les étapes de vérification : votre agent suit la checklist communautaire avant d'installer tout ce qui contient du code exécutable. Vous en voulez plus ?
Certificat de vérification
Faits datés sur ce qui a été vérifié pour cette fiche, et comment. Ce n’est pas une certification de sécurité.
- Version épinglée
- f3656c6 · 2026-10-20
- Test d’installation en sandbox
- Installation exécutée dans notre sandbox de test · 18 nov. 2026 · Observé pendant le test d’installation: registry.npmjs.org
- Identité du créateur
- Non vérifiée
- Veille d’empreinte
- Dernière vérification · 19 nov. 2026 : aucun changement détecté dans les fichiers liés par ce prompt d’installation
- Analyse du prompt d’installation
- 2026-10-13 : Aucune commande, appel réseau, paquet, écriture de fichier ni clé API détecté.
Skill Harbor ne révise jamais le code des skills listés. Ce sont des faits datés sur le prompt d’installation et notre test d’installation, pas une certification de sécurité. Révisez un skill vous-même avant de l’installer. Comment nous vérifions
Questions
Comment installer un skill ?
Chaque fiche produit contient un prompt d’installation à copier-coller. Collez-le dans votre Muse et il installe le skill pour vous — sans configuration manuelle.
Où va mon argent ?
Directement au vendeur. Skill Harbor ne traite jamais les paiements : le paiement se fait sur la page du vendeur, généralement via Stripe.
Que signifie le ✓ à côté du nom d’un créateur ?
Il signifie que nous avons confirmé l’identité de la personne derrière la fiche. Il ne dit rien sur le code lui-même — vérifiez toujours un skill avant de l’installer.