Donner une adresse e-mail a votre agent IA de codage

Pourquoi donner une adresse e-mail a un agent IA de codage ?

Les agents IA de codage capables de lire et d'envoyer des e-mails deviennent aptes a des taches que la simple generation de code ne peut pas gerer : envoyer des notifications de deploiement, extraire des codes OTP de flux d'inscription et planifier des reunions apres des revues de code. L'e-mail transforme un agent limite au code en un agent qui interagit avec les personnes et les services en dehors du depot.

Les workflows agent-vers-e-mail deviennent un pattern essentiel pour les developpeurs, car les agents ont besoin d'un moyen durable d'echanger des messages avec des personnes, des services et d'autres agents. La plupart des solutions vous enferment chez un seul fournisseur : les serveurs MCP Gmail ne fonctionnent qu'avec Google, et Microsoft Graph ne fonctionne qu'avec Outlook. Nylas CLI se connecte aux 6 principaux fournisseurs de messagerie via un seul flux d'authentification et fonctionne avec tout agent de codage compatible MCP.

Etape 1 : S'inscrire, connecter un compte et configurer le CLI

Avant de connecter un agent, vous avez besoin d'un compte Nylas avec au moins un grant e-mail et du Nylas CLI authentifie avec votre cle API. L'ensemble des prerequis prend environ 2 minutes et ne doit etre fait qu'une seule fois — chaque agent connecte ensuite reutilise les memes identifiants et le meme grant.

1. S'inscrire sur Nylas et creer une cle API

Rendez-vous sur dashboard-v3.nylas.com, creez un compte gratuit et generez une cle API dans les parametres. Le plan gratuit Nylas inclut jusqu'a 5 comptes connectes.

2. Connecter au moins un compte e-mail sous Grants

Dans le tableau de bord Nylas, allez dans Grants et connectez un compte Gmail, Outlook, Exchange, Yahoo, iCloud ou IMAP. C'est l'adresse e-mail que votre agent IA utilisera. Nylas gere le flux OAuth pour Google et Microsoft, vous n'avez donc pas besoin d'enregistrer votre propre application OAuth.

3. Installer Nylas CLI et configurer votre cle API

Nylas CLI est un binaire unique sans dependance d'execution. Sur macOS et Linux, Homebrew est la methode d'installation la plus rapide. Apres l'installation, lancez nylas auth config --api-key pour stocker votre cle API localement, puis verifiez avec nylas auth whoami.

# Installer (macOS / Linux)
brew install nylas/nylas-cli/nylas

# Configurer votre cle API
nylas auth config --api-key YOUR_NYLAS_API_KEY

# Verifier la connexion
nylas auth whoami

Sur Windows ou pour les installations par script shell et Go, consultez le guide de demarrage.

Remplacez YOUR_NYLAS_API_KEY par la cle du tableau de bord Nylas. Selon la documentation MCP de Nylas, cela donne a votre agent acces a 16 outils d'e-mail, de calendrier et de contacts sur les 6 fournisseurs.

Etape 2a : Donner une adresse e-mail a Claude Code

Claude Code supporte MCP nativement, la connexion a un vrai compte e-mail se fait en une seule commande. Nylas CLI ecrit la configuration du serveur MCP et pre-approuve les 16 outils dans le fichier de parametres de Claude Code, eliminant les demandes de permission par outil qui interrompraient sinon chaque action e-mail.

La commande nylas mcp install cible directement les fichiers de configuration de Claude Code. Elle ajoute une entree serveur dans ~/.claude.json et une permission wildcard pour mcp__nylas__* dans ~/.claude/settings.json.

# Installer MCP pour Claude Code
nylas mcp install --assistant claude-code

Apres avoir lance cette commande, redemarrez Claude Code pour qu'il detecte le nouveau serveur MCP. Les 16 outils Nylas sont pre-approuves sans invites interactives. Essayez ces requetes en langage naturel :

• "Lis mes 5 derniers e-mails"
• "Envoie un e-mail a alice@example.com au sujet du deploiement"
• "Verifie mon calendrier pour demain"

Pour le guide complet sur MCP -- outils disponibles, endpoints regionaux, gestion des fuseaux horaires -- consultez le guide AI Agent Email Access via MCP.

Etape 2b : Donner une adresse e-mail a Cursor

Cursor supporte MCP nativement, et Nylas CLI le configure avec une seule commande. Cursor offre deux methodes de connexion : un serveur STDIO local via le CLI, ou un endpoint HTTP heberge qui se passe entierement du CLI. Les deux methodes exposent les memes 16 outils au mode agent de Cursor.

La methode locale execute nylas mcp install --assistant cursor, qui ecrit une entree serveur dans ~/.cursor/mcp.json. Le processus CLI s'execute comme serveur STDIO local et gere tous les appels API vers Nylas.

# Installer MCP pour Cursor
nylas mcp install --assistant cursor

Apres l'installation, redemarrez Cursor, ouvrez les parametres et verifiez dans Tools & MCP qu'un point vert apparait a cote de "nylas".

Alternative : serveur MCP heberge (sans installation du CLI). Cursor supporte aussi les serveurs MCP HTTP streamable. Cette methode se connecte directement a l'endpoint MCP de Nylas a mcp.us.nylas.com, sans besoin d'un processus CLI local. Ajoutez ceci dans ~/.cursor/mcp.json :

{
  "mcpServers": {
    "nylas": {
      "type": "streamable-http",
      "url": "https://mcp.us.nylas.com",
      "headers": {
        "Authorization": "Bearer YOUR_NYLAS_API_KEY"
      }
    }
  }
}

Remplacez YOUR_NYLAS_API_KEY par votre cle API du tableau de bord Nylas. Cela contourne entierement le proxy CLI local. La documentation MCP de Nylas couvre les deux methodes.

Etape 2c : Donner une adresse e-mail a OpenAI Codex CLI

OpenAI Codex CLI supporte les serveurs MCP nativement et offre trois methodes de connexion : STDIO local via Nylas CLI, un endpoint HTTP heberge, ou des commandes shell directes sans MCP. Selon la documentation MCP d'OpenAI Codex, Codex lance automatiquement les serveurs MCP au demarrage d'une session, sans processus manuel a maintenir.

Option A : MCP local via Nylas CLI

La commande codex mcp add enregistre Nylas comme serveur STDIO local. Codex stocke cela dans ~/.codex/config.toml et demarre le processus serveur au debut de chaque session.

# Ajouter Nylas comme serveur MCP (STDIO)
codex mcp add nylas -- nylas mcp serve

Cela ajoute une entree [mcp_servers.nylas] dans ~/.codex/config.toml. La configuration resultante ressemble a ceci :

# ~/.codex/config.toml
[mcp_servers.nylas]
command = "nylas"
args = ["mcp", "serve"]

Option B : Serveur MCP heberge (sans installation du CLI)

La methode hebergee connecte Codex directement a l'endpoint MCP de Nylas via HTTP, sans passer par le processus CLI local. Codex lit le token bearer depuis une variable d'environnement, la cle API n'apparait donc jamais dans le fichier de configuration. Ajoutez l'entree serveur dans ~/.codex/config.toml et definissez la variable d'environnement NYLAS_API_KEY dans votre profil shell.

# ~/.codex/config.toml
[mcp_servers.nylas]
url = "https://mcp.us.nylas.com"
bearer_token_env_var = "NYLAS_API_KEY"

# Definir la variable d'environnement
export NYLAS_API_KEY="your-api-key-here"

Option C : Commandes shell (sans MCP)

Codex peut aussi executer des commandes Nylas CLI directement dans son shell sandboxe sans MCP. Chaque commande s'execute dans le sandbox de Codex, qui requiert une approbation utilisateur avant l'execution -- ajoutant une etape de confirmation manuelle pour chaque action. Les commandes CLI retournent du texte brut par defaut ou du JSON structure avec le flag --json, que Codex peut analyser pour un raisonnement ulterieur.

# Lire les e-mails recents
nylas email list --limit 10

# Rechercher des e-mails specifiques
nylas email search "deploy notification"

# Envoyer un e-mail
nylas email send --to alice@example.com --subject "Deploy complete" --body "v2.4.1 is live."

# Sortie JSON pour l'analyse structuree
nylas email list --limit 5 --json

Pour construire des definitions d'outils structurees autour des commandes shell, consultez Build an LLM Agent with Email Tools.

Etape 2d : Donner une adresse e-mail a OpenClaw

OpenClaw utilise un systeme de plugins au lieu de MCP, la configuration differe donc des 4 autres agents. Le plugin Nylas donne a OpenClaw des outils natifs d'e-mail, de calendrier et de contacts avec des schemas types et un support multi-comptes. L'installation necessite 6 commandes : installer le plugin, l'autoriser, configurer la cle API, redemarrer la gateway et verifier.

Le systeme de plugins requiert une configuration de confiance explicite. Apres l'installation du package du plugin, vous devez ajouter "nylas" a la fois dans plugins.allow et tools.alsoAllow pour qu'OpenClaw expose les outils aux sessions d'agent. Le redemarrage de la gateway assure le chargement de la nouvelle configuration du plugin.

# Installer le plugin Nylas
openclaw plugins install @nylas/openclaw-nylas-plugin

# Faire confiance au plugin et exposer ses outils aux sessions d'agent
openclaw config set 'plugins.allow' '["nylas"]'
openclaw config set 'tools.alsoAllow' '["nylas"]'

# Configurer votre cle API
openclaw config set 'plugins.entries.nylas.config.apiKey' 'YOUR_NYLAS_API_KEY'

# Redemarrer la gateway pour recharger la configuration du plugin
openclaw gateway restart

# Verifier que le plugin peut voir vos comptes connectes
openclaw plugins list
openclaw run "List my connected email accounts" --plugin nylas

Une fois installe, OpenClaw peut envoyer des e-mails, lire des fils de discussion, gerer des evenements de calendrier et rechercher des contacts en langage naturel. Le plugin decouvre automatiquement tous les comptes e-mail connectes depuis le tableau de bord Nylas -- aucune configuration par compte n'est necessaire.

Les details complets de la configuration se trouvent dans le guide Install the OpenClaw Nylas Plugin . Vous debutez avec OpenClaw ? Commencez par le guide de configuration d'OpenClaw CLI.

Comparaison : configuration e-mail selon les agents IA de codage

Cinq agents IA de codage peuvent se connecter a l'e-mail via Nylas, et chacun utilise un fichier de configuration et une methode d'integration differents. Quatre d'entre eux -- Claude Code, Cursor, Codex CLI et Windsurf -- se connectent via MCP en utilisant soit un serveur STDIO local, soit un endpoint HTTP heberge. OpenClaw se connecte via son propre systeme de plugins. Le tableau resume la commande de configuration et l'emplacement du fichier de configuration pour chaque agent.

Les cinq agents obtiennent les memes 16 outils d'e-mail, de calendrier et de contacts. Les agents MCP (Claude Code, Cursor, Codex, Windsurf) se connectent via le serveur MCP de Nylas. OpenClaw se connecte via son systeme de plugins. Chaque methode supporte les 6 fournisseurs de messagerie : Gmail, Outlook, Exchange, Yahoo, iCloud et IMAP.

Ce que votre agent peut faire avec l'acces e-mail

Un agent IA de codage avec acces e-mail peut gerer 6 categories de taches qui necessiteraient autrement de basculer vers un client de messagerie : envoyer des notifications, lire des confirmations, extraire des codes OTP, planifier des reunions, rechercher dans l'historique des e-mails et rediger des reponses. Les 16 outils MCP fonctionnent avec des instructions en langage naturel -- pas besoin de flags ni de syntaxe de commande.

• Envoyer une notification de deploiement -- "Envoie un e-mail a l'equipe pour dire que la v2.4.1 est en production"
• Lire un e-mail de confirmation -- "Verifie ma boite de reception pour la confirmation d'inscription AWS"
• Extraire un code OTP -- "Recupere le code de verification a 6 chiffres de mon dernier e-mail" (voir Email as Identity for AI Agents)
• Planifier une reunion -- "Reserve un appel de 30 minutes avec alice@company.com mardi prochain a 14h"
• Rechercher dans l'historique des e-mails -- "Trouve tous les e-mails sur le contrat Q4 et resume les decisions cles"
• Rediger une reponse -- "Redige une reponse a la question de Sarah sur le budget avec les chiffres mis a jour"

Securite et controle d'acces

Donner a un agent IA un acces e-mail necessite des garde-fous pour empecher les envois non intentionnels et les acces non autorises aux donnees. Nylas CLI et MCP imposent un pattern d'envoi en 2 etapes : l'agent cree d'abord un brouillon, puis une etape de confirmation separee l'approuve avant qu'un e-mail ne quitte le compte. Ce pattern s'applique aux 5 agents supportes et couvre 100 % des actions e-mail sortantes.

• Confirmation d'envoi requise. Les outils MCP exigent une etape confirm_send_draft avant tout envoi reel d'e-mail. Votre agent cree d'abord un brouillon, puis vous l'approuvez.
• Stockage local des identifiants. Nylas CLI stocke les tokens OAuth sur votre machine. Ils ne quittent pas votre systeme sauf si vous executez une commande.
• Execution sandboxee. Codex CLI execute les commandes shell dans un sandbox avec approbation utilisateur pour chaque action.
• Revocation a tout moment. Lancez nylas auth logout pour vous deconnecter, ou nylas auth list pour voir les comptes connectes.

Pour un journal d'audit complet de chaque action de vos agents IA avec l'e-mail, consultez le guide Audit AI Agent Activity.

Prochaines etapes

Avec l'acces e-mail configure, les suites logiques sont la mise en place de garde-fous pour controler ce que l'agent peut envoyer, l'audit de l'activite de l'agent pour la conformite et la construction de workflows d'agent personnalises en Python ou TypeScript. Les guides listes ici couvrent le cycle complet, de l'acces initial a l'e-mail jusqu'a une infrastructure e-mail d'agent en production.

• Stop Your AI Agent From Going Rogue -- regles de confinement qui bloquent les envois sortants risques et les boucles de reponse automatique au niveau de la politique
• AI Agent Email Access via MCP -- guide complet sur MCP avec les 16 outils, les endpoints regionaux et la gestion des fuseaux horaires
• ChatGPT Gmail Connector vs MCP -- comparer les apps ChatGPT hebergees, les apps MCP personnalisees et le MCP CLI local
• MCP Email Server Security Checklist -- moindre privilege, limites de tokens, verification de webhooks et controles d'ecriture
• MCP vs API for AI Agents -- benchmarks et matrice de decision pour choisir entre MCP, API directe ou skills
• Build an LLM Agent with Email Tools -- patterns de sous-processus pour agents personnalises en Python et TypeScript
• Why AI Agents Need Email -- authentification, OTP, pistes d'audit et conversations multi-thread
• Audit AI Agent Activity -- suivre chaque action de Claude Code, Copilot et des agents MCP
• Create an AI Agent Email Identity -- donner a l'agent sa propre boite provider=nylas geree au lieu d'emprunter la votre
• Reference complete des commandes -- chaque flag, sous-commande et exemple
• Documentation MCP de Nylas -- configuration officielle du serveur et reference API