Serveur MCP Forward Email
En bref : Notre serveur MCP open-source permet aux assistants IA comme Claude, ChatGPT, Cursor et Windsurf de gĂ©rer vos emails, domaines, alias, contacts et calendriers via le langage naturel. Les 68 points dâAPI sont tous exposĂ©s comme outils MCP. Il sâexĂ©cute localement via npx @forwardemail/mcp-server â vos identifiants ne quittent jamais votre machine.
Quâest-ce que MCP ?
Model Context Protocol (MCP) est une norme ouverte créée par Anthropic qui permet aux modĂšles IA dâappeler en toute sĂ©curitĂ© des outils externes. Au lieu de copier-coller les rĂ©ponses dâAPI dans une fenĂȘtre de chat, MCP donne au modĂšle un accĂšs direct et structurĂ© Ă vos services.
Notre serveur MCP enveloppe toute lâAPI Forward Email â chaque point dâaccĂšs, chaque paramĂštre â et les expose comme des outils que tout client compatible MCP peut utiliser. Le serveur sâexĂ©cute localement sur votre machine via un transport stdio. Vos identifiants restent dans vos variables dâenvironnement et ne sont jamais envoyĂ©s au modĂšle IA.
Démarrage rapide
Obtenir une clé API
- Connectez-vous Ă votre compte Forward Email.
- Allez dans Mon Compte â SĂ©curitĂ© â ClĂ©s API.
- Générez une nouvelle clé API et copiez-la.
Claude Desktop
Ajoutez ceci Ă votre fichier de configuration Claude Desktop :
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"forwardemail": {
"command": "npx",
"args": ["-y", "@forwardemail/mcp-server"],
"env": {
"FORWARD_EMAIL_API_KEY": "your-api-key-here",
"FORWARD_EMAIL_ALIAS_USER": "you@example.com",
"FORWARD_EMAIL_ALIAS_PASSWORD": "your-generated-alias-password"
}
}
}
}
Redémarrez Claude Desktop. Vous devriez voir les outils Forward Email dans le sélecteur d'outils.
Note : Les variables
FORWARD_EMAIL_ALIAS_USERetFORWARD_EMAIL_ALIAS_PASSWORDsont optionnelles mais requises pour les outils de boßte aux lettres (messages, dossiers, contacts, calendriers). Voir Authentification pour plus de détails.
Cursor
Ouvrez les ParamĂštres de Cursor â MCP â Ajouter un Serveur :
{
"mcpServers": {
"forwardemail": {
"command": "npx",
"args": ["-y", "@forwardemail/mcp-server"],
"env": {
"FORWARD_EMAIL_API_KEY": "your-api-key-here",
"FORWARD_EMAIL_ALIAS_USER": "you@example.com",
"FORWARD_EMAIL_ALIAS_PASSWORD": "your-generated-alias-password"
}
}
}
}
Windsurf
Ouvrez les ParamĂštres de Windsurf â MCP â Ajouter un Serveur avec la mĂȘme configuration que ci-dessus.
Autres Clients MCP
Tout client supportant le transport MCP stdio fonctionnera. La commande est :
FORWARD_EMAIL_API_KEY=your-api-key \
FORWARD_EMAIL_ALIAS_USER=you@example.com \
FORWARD_EMAIL_ALIAS_PASSWORD=your-generated-alias-password \
npx @forwardemail/mcp-server
Authentification
LâAPI Forward Email utilise lâauthentification HTTP Basic avec deux types dâidentifiants diffĂ©rents selon le point de terminaison. Le serveur MCP gĂšre cela automatiquement â vous devez simplement fournir les bons identifiants.
Authentification par Clé API
La plupart des points de terminaison de gestion (domaines, alias, emails sortants, journaux) utilisent votre clĂ© API comme nom dâutilisateur Basic auth avec un mot de passe vide.
Câest la mĂȘme clĂ© API que vous utilisez pour lâAPI REST. Configurez-la via la variable dâenvironnement FORWARD_EMAIL_API_KEY.
Authentification par Alias
Les points de terminaison de boĂźte aux lettres (messages, dossiers, contacts, calendriers, scripts sieve liĂ©s Ă un alias) utilisent des identifiants dâalias â lâadresse email de lâalias comme nom dâutilisateur et un mot de passe gĂ©nĂ©rĂ© comme mot de passe.
Ces points de terminaison accĂšdent aux donnĂ©es par alias via les protocoles IMAP, CalDAV et CardDAV. Ils nĂ©cessitent lâemail de lâalias et un mot de passe gĂ©nĂ©rĂ©, pas la clĂ© API.
Vous pouvez fournir les identifiants dâalias de deux façons :
- Variables dâenvironnement (recommandĂ© pour lâalias par dĂ©faut) : dĂ©finissez
FORWARD_EMAIL_ALIAS_USERetFORWARD_EMAIL_ALIAS_PASSWORD. - ParamĂštres par appel dâoutil : passez
alias_usernameetalias_passworden arguments Ă nâimporte quel outil dâauth alias. Ceux-ci remplacent les variables dâenvironnement, ce qui est utile lorsque vous travaillez avec plusieurs alias.
GĂ©nĂ©ration dâun Mot de Passe dâAlias
Avant de pouvoir utiliser les outils dâauth alias, vous devez gĂ©nĂ©rer un mot de passe pour lâalias. Vous pouvez le faire avec lâoutil generateAliasPassword ou via lâAPI :
curl -u "YOUR_API_KEY:" \
https://api.forwardemail.net/v1/domains/example.com/aliases/ALIAS_ID/generate-password \
-X POST
La rĂ©ponse inclut les champs username (email de lâalias) et password. Utilisez-les comme identifiants dâalias.
Astuce : Vous pouvez aussi demander Ă votre assistant IA : « GĂ©nĂšre un mot de passe pour lâalias user@example.com sur le domaine example.com » â il appellera lâoutil
generateAliasPasswordet retournera les identifiants.
Le tableau ci-dessous rĂ©sume la mĂ©thode dâauthentification requise pour chaque groupe dâoutils :
| Groupe dâOutils | MĂ©thode dâAuth | Identifiants |
|---|---|---|
| Compte | ClĂ© API ou Auth Alias | Lâun ou lâautre |
| Domaines, Alias, Membres de Domaine, Invitations, Mots de Passe Catch-All | Clé API | FORWARD_EMAIL_API_KEY |
| Emails Sortants (liste, obtention, suppression, limite) | Clé API | FORWARD_EMAIL_API_KEY |
| Envoi dâEmail | ClĂ© API ou Auth Alias | Lâun ou lâautre |
| Messages (IMAP) | Auth Alias | FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD |
| Dossiers (IMAP) | Auth Alias | FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD |
| Contacts (CardDAV) | Auth Alias | FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD |
| Calendriers (CalDAV) | Auth Alias | FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD |
| ĂvĂ©nements de Calendrier (CalDAV) | Auth Alias | FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD |
| Scripts Sieve (portée domaine) | Clé API | FORWARD_EMAIL_API_KEY |
| Scripts Sieve (portée alias) | Auth Alias | FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD |
| Journaux | Clé API | FORWARD_EMAIL_API_KEY |
| Chiffrement | Aucun | Aucun identifiant requis |
Tous les 68 Outils
Chaque outil correspond directement Ă un point de terminaison de la Forward Email API. Les paramĂštres utilisent les mĂȘmes noms que dans la documentation de l'API. La mĂ©thode d'authentification est indiquĂ©e dans le titre de chaque section.
Compte (Authentification par clé API ou alias)
Avec l'authentification par clé API, ces outils retournent les informations de votre compte utilisateur. Avec l'authentification par alias, ils retournent les informations de l'alias/boßte aux lettres, y compris le quota de stockage et les paramÚtres.
| Outil | Point de terminaison API | Description |
|---|---|---|
getAccount |
GET /v1/account |
Obtenir les informations de votre compte |
updateAccount |
PUT /v1/account |
Mettre Ă jour les paramĂštres de votre compte |
Domaines (Clé API)
| Outil | Point de terminaison API | Description |
|---|---|---|
listDomains |
GET /v1/domains |
Lister tous vos domaines |
createDomain |
POST /v1/domains |
Ajouter un nouveau domaine |
getDomain |
GET /v1/domains/:domain_id |
Obtenir les détails du domaine |
updateDomain |
PUT /v1/domains/:domain_id |
Mettre Ă jour les paramĂštres du domaine |
deleteDomain |
DELETE /v1/domains/:domain_id |
Supprimer un domaine |
verifyDomainRecords |
GET /v1/domains/:domain_id/verify-records |
Vérifier les enregistrements DNS |
verifySmtpRecords |
GET /v1/domains/:domain_id/verify-smtp |
Vérifier la configuration SMTP |
testS3Connection |
POST /v1/domains/:domain_id/test-s3-connection |
Tester le stockage S3 personnalisé |
Alias (Clé API)
| Outil | Point de terminaison API | Description |
|---|---|---|
listAliases |
GET /v1/domains/:domain_id/aliases |
Lister les alias pour un domaine |
createAlias |
POST /v1/domains/:domain_id/aliases |
Créer un nouvel alias |
getAlias |
GET /v1/domains/:domain_id/aliases/:alias_id |
Obtenir les détails d'un alias |
updateAlias |
PUT /v1/domains/:domain_id/aliases/:alias_id |
Mettre Ă jour un alias |
deleteAlias |
DELETE /v1/domains/:domain_id/aliases/:alias_id |
Supprimer un alias |
generateAliasPassword |
POST /v1/domains/:domain_id/aliases/:alias_id/generate-password |
Générer un mot de passe IMAP/SMTP pour l'authentification par alias |
Emails â SMTP sortant (ClĂ© API ; Send supporte les deux)
| Outil | Point de terminaison API | Authentification | Description |
|---|---|---|---|
sendEmail |
POST /v1/emails |
Clé API ou Auth alias | Envoyer un email via SMTP |
listEmails |
GET /v1/emails |
Clé API | Lister les emails sortants |
getEmail |
GET /v1/emails/:id |
Clé API | Obtenir les détails et le statut d'un email |
deleteEmail |
DELETE /v1/emails/:id |
Clé API | Supprimer un email en file d'attente |
getEmailLimit |
GET /v1/emails/limit |
Clé API | Vérifier votre limite d'envoi |
L'outil sendEmail accepte from, to, cc, bcc, subject, text, html et attachments. C'est identique au point de terminaison POST /v1/emails.
Messages â IMAP (Authentification par alias)
Nécessite les identifiants de l'alias. Passez
alias_usernameetalias_passwordou définissez les variables d'environnementFORWARD_EMAIL_ALIAS_USERetFORWARD_EMAIL_ALIAS_PASSWORD. | Outil | Point de terminaison API | Description | | --------------- | --------------------------- | ----------------------------------- | |listMessages|GET /v1/messages| Lister et rechercher des messages dans une boßte aux lettres | |createMessage|POST /v1/messages| Créer un brouillon ou télécharger un message | |getMessage|GET /v1/messages/:id| Obtenir un message par ID | |updateMessage|PUT /v1/messages/:id| Mettre à jour les indicateurs (lu, étoilé, etc.) | |deleteMessage|DELETE /v1/messages/:id| Supprimer un message |
Lâoutil listMessages prend en charge plus de 15 paramĂštres de recherche incluant subject, from, to, text, since, before, is_unread et has_attachment. Voir les docs API pour la liste complĂšte.
Dossiers â IMAP (Authentification Alias)
Nécessite les identifiants alias. Passez
alias_usernameetalias_passwordou dĂ©finissez les variables dâenvironnementFORWARD_EMAIL_ALIAS_USERetFORWARD_EMAIL_ALIAS_PASSWORD.
| Outil | Point de terminaison API | Description |
|---|---|---|
listFolders |
GET /v1/folders |
Lister tous les dossiers de la boĂźte aux lettres |
createFolder |
POST /v1/folders |
Créer un nouveau dossier |
getFolder |
GET /v1/folders/:id |
Obtenir les dĂ©tails dâun dossier |
updateFolder |
PUT /v1/folders/:id |
Renommer un dossier |
deleteFolder |
DELETE /v1/folders/:id |
Supprimer un dossier |
Contacts â CardDAV (Authentification Alias)
Nécessite les identifiants alias. Passez
alias_usernameetalias_passwordou dĂ©finissez les variables dâenvironnementFORWARD_EMAIL_ALIAS_USERetFORWARD_EMAIL_ALIAS_PASSWORD.
| Outil | Point de terminaison API | Description |
|---|---|---|
listContacts |
GET /v1/contacts |
Lister tous les contacts |
createContact |
POST /v1/contacts |
Créer un nouveau contact |
getContact |
GET /v1/contacts/:id |
Obtenir les dĂ©tails dâun contact |
updateContact |
PUT /v1/contacts/:id |
Mettre Ă jour un contact |
deleteContact |
DELETE /v1/contacts/:id |
Supprimer un contact |
Calendriers â CalDAV (Authentification Alias)
Nécessite les identifiants alias. Passez
alias_usernameetalias_passwordou dĂ©finissez les variables dâenvironnementFORWARD_EMAIL_ALIAS_USERetFORWARD_EMAIL_ALIAS_PASSWORD.
| Outil | Point de terminaison API | Description |
|---|---|---|
listCalendars |
GET /v1/calendars |
Lister tous les calendriers |
createCalendar |
POST /v1/calendars |
Créer un nouveau calendrier |
getCalendar |
GET /v1/calendars/:id |
Obtenir les dĂ©tails dâun calendrier |
updateCalendar |
PUT /v1/calendars/:id |
Mettre Ă jour un calendrier |
deleteCalendar |
DELETE /v1/calendars/:id |
Supprimer un calendrier |
ĂvĂ©nements de calendrier â CalDAV (Authentification Alias)
Nécessite les identifiants alias. Passez
alias_usernameetalias_passwordou dĂ©finissez les variables dâenvironnementFORWARD_EMAIL_ALIAS_USERetFORWARD_EMAIL_ALIAS_PASSWORD.
| Outil | Point de terminaison API | Description |
|---|---|---|
listCalendarEvents |
GET /v1/calendar-events |
Lister tous les événements |
createCalendarEvent |
POST /v1/calendar-events |
Créer un nouvel événement |
getCalendarEvent |
GET /v1/calendar-events/:id |
Obtenir les dĂ©tails dâun Ă©vĂ©nement |
updateCalendarEvent |
PUT /v1/calendar-events/:id |
Mettre à jour un événement |
deleteCalendarEvent |
DELETE /v1/calendar-events/:id |
Supprimer un événement |
Scripts Sieve (Clé API)
Ces scripts utilisent des chemins spĂ©cifiques au domaine et sâauthentifient avec votre clĂ© API.
| Outil | Point de terminaison API | Description |
|---|---|---|
listSieveScripts |
GET /v1/domains/:domain_id/aliases/:alias_id/sieve |
Lister les scripts pour un alias |
createSieveScript |
POST /v1/domains/:domain_id/aliases/:alias_id/sieve |
Créer un nouveau script |
getSieveScript |
GET /v1/domains/:domain_id/aliases/:alias_id/sieve/:script_id |
Obtenir les détails du script |
updateSieveScript |
PUT /v1/domains/:domain_id/aliases/:alias_id/sieve/:script_id |
Mettre Ă jour un script |
deleteSieveScript |
DELETE /v1/domains/:domain_id/aliases/:alias_id/sieve/:script_id |
Supprimer un script |
activateSieveScript |
POST /v1/domains/:domain_id/aliases/:alias_id/sieve/:script_id/activate |
Activer un script |
Scripts Sieve (Authentification Alias)
Ils utilisent l'authentification au niveau de l'alias. Utile pour l'automatisation par alias sans avoir besoin de la clé API.
Nécessite les identifiants de l'alias. Passez
alias_usernameetalias_passwordou définissez les variables d'environnementFORWARD_EMAIL_ALIAS_USERetFORWARD_EMAIL_ALIAS_PASSWORD.
| Outil | Point d'API | Description |
|---|---|---|
listSieveScriptsAliasAuth |
GET /v1/sieve-scripts |
Lister les scripts |
createSieveScriptAliasAuth |
POST /v1/sieve-scripts |
Créer un script |
getSieveScriptAliasAuth |
GET /v1/sieve-scripts/:script_id |
Obtenir les détails d'un script |
updateSieveScriptAliasAuth |
PUT /v1/sieve-scripts/:script_id |
Mettre Ă jour un script |
deleteSieveScriptAliasAuth |
DELETE /v1/sieve-scripts/:script_id |
Supprimer un script |
activateSieveScriptAliasAuth |
POST /v1/sieve-scripts/:script_id/activate |
Activer un script |
Membres et Invitations de Domaine (Clé API)
| Outil | Point d'API | Description |
|---|---|---|
updateDomainMember |
PUT /v1/domains/:domain_id/members/:member_id |
Modifier le rĂŽle d'un membre |
removeDomainMember |
DELETE /v1/domains/:domain_id/members/:member_id |
Supprimer un membre |
acceptDomainInvite |
GET /v1/domains/:domain_id/invites |
Accepter une invitation en attente |
createDomainInvite |
POST /v1/domains/:domain_id/invites |
Inviter quelqu'un dans un domaine |
removeDomainInvite |
DELETE /v1/domains/:domain_id/invites |
Révoquer une invitation |
Mots de Passe Catch-All (Clé API)
| Outil | Point d'API | Description |
|---|---|---|
listCatchAllPasswords |
GET /v1/domains/:domain_id/catch-all-passwords |
Lister les mots de passe catch-all |
createCatchAllPassword |
POST /v1/domains/:domain_id/catch-all-passwords |
Créer un mot de passe catch-all |
deleteCatchAllPassword |
DELETE /v1/domains/:domain_id/catch-all-passwords/:token_id |
Supprimer un mot de passe catch-all |
Journaux (Clé API)
| Outil | Point d'API | Description |
|---|---|---|
downloadLogs |
GET /v1/logs/download |
Télécharger les journaux de livraison des emails |
Chiffrement (Sans Auth)
| Outil | Point d'API | Description |
|---|---|---|
encryptRecord |
POST /v1/encrypt |
Chiffrer un enregistrement DNS TXT |
Cet outil ne nécessite pas d'authentification. Il chiffre les enregistrements de redirection comme forward-email=user@example.com pour une utilisation dans les enregistrements DNS TXT.
20 Cas d'Utilisation Concrets
Voici des façons pratiques d'utiliser le serveur MCP avec votre assistant IA :
1. Tri des Emails
Demandez Ă votre IA de scanner votre boĂźte de rĂ©ception et de rĂ©sumer les messages non lus. Elle peut signaler les emails urgents, les catĂ©goriser par expĂ©diteur, et rĂ©diger des rĂ©ponses â tout cela en langage naturel. (NĂ©cessite les identifiants de l'alias pour accĂ©der Ă la boĂźte de rĂ©ception.)
2. Automatisation de la Configuration de Domaine
Vous configurez un nouveau domaine ? Demandez à l'IA de créer le domaine, d'ajouter vos alias, de vérifier les enregistrements DNS, et de tester la configuration SMTP. Ce qui prend normalement 10 minutes de clics dans les tableaux de bord devient une seule conversation.
3. Gestion en Masse des Alias
Besoin de créer 20 alias pour un nouveau projet ? Décrivez ce dont vous avez besoin et laissez l'IA gérer le travail répétitif. Elle peut créer des alias, définir des rÚgles de redirection, et générer des mots de passe en une seule fois.
4. Surveillance des campagnes email
Demandez Ă votre IA de vĂ©rifier les limites dâenvoi, de lister les emails sortants rĂ©cents, et de faire un rapport sur le statut de livraison. Utile pour surveiller la santĂ© des emails transactionnels.
5. Synchronisation et nettoyage des contacts
Utilisez les outils CardDAV pour lister tous les contacts, trouver les doublons, mettre Ă jour les informations obsolĂštes, ou crĂ©er en masse des contacts Ă partir dâun tableau que vous collez dans le chat. (NĂ©cessite les identifiants dâalias.)
6. Gestion du calendrier
CrĂ©ez des calendriers, ajoutez des Ă©vĂ©nements, mettez Ă jour les horaires de rĂ©union, et supprimez les Ă©vĂ©nements annulĂ©s â tout cela par conversation. Les outils CalDAV supportent le CRUD complet sur les calendriers et les Ă©vĂ©nements. (NĂ©cessite les identifiants dâalias.)
7. Automatisation des scripts Sieve
Les scripts Sieve sont puissants mais leur syntaxe est obscure. Demandez Ă votre IA dâĂ©crire des scripts Sieve pour vous : « Filtrer tous les emails de billing@example.com dans un dossier Facturation » devient un script fonctionnel sans toucher Ă la spĂ©cification RFC 5228.
8. IntĂ©gration des membres de lâĂ©quipe
Quand un nouveau membre rejoint lâĂ©quipe, demandez Ă lâIA de crĂ©er son alias, gĂ©nĂ©rer un mot de passe, lui envoyer un email de bienvenue avec ses identifiants, et lâajouter comme membre du domaine. Une seule commande, quatre appels API.
9. Audit de sécurité
Demandez Ă votre IA de lister tous les domaines, vĂ©rifier le statut de vĂ©rification DNS, examiner les configurations dâalias, et identifier les domaines avec des enregistrements non vĂ©rifiĂ©s. Un contrĂŽle de sĂ©curitĂ© rapide en langage naturel.
10. Configuration du transfert dâemail
Vous configurez le transfert dâemail pour un nouveau domaine ? Demandez Ă lâIA de crĂ©er le domaine, ajouter les alias de transfert, chiffrer les enregistrements DNS, et vĂ©rifier que tout est configurĂ© correctement.
11. Recherche et analyse dans la boßte de réception
Utilisez les outils de recherche de messages pour trouver des emails spĂ©cifiques : « Trouve tous les emails de john@example.com des 30 derniers jours qui ont des piĂšces jointes. » Les plus de 15 paramĂštres de recherche rendent cela puissant. (NĂ©cessite les identifiants dâalias.)
12. Organisation des dossiers
Demandez Ă votre IA de crĂ©er une structure de dossiers pour un nouveau projet, dĂ©placer des messages entre dossiers, ou nettoyer les anciens dossiers dont vous nâavez plus besoin. (NĂ©cessite les identifiants dâalias.)
13. Rotation des mots de passe
GĂ©nĂ©rez de nouveaux mots de passe dâalias selon un planning. Demandez Ă votre IA de gĂ©nĂ©rer un nouveau mot de passe pour chaque alias et de rapporter les nouvelles informations dâidentification.
14. Chiffrement des enregistrements DNS
Chiffrez vos enregistrements de transfert avant de les ajouter au DNS. Lâoutil encryptRecord gĂšre cela sans authentification â utile pour des chiffrages rapides ponctuels.
15. Analyse des journaux de livraison
TĂ©lĂ©chargez vos journaux de livraison dâemails et demandez Ă lâIA dâanalyser les taux de rebond, dâidentifier les destinataires problĂ©matiques, ou de suivre les temps de livraison.
16. Gestion multi-domaines
Si vous gĂ©rez plusieurs domaines, demandez Ă lâIA de vous fournir un rapport dâĂ©tat : quels domaines sont vĂ©rifiĂ©s, lesquels ont des problĂšmes, combien dâalias chacun possĂšde, et Ă quoi ressemblent les limites dâenvoi.
17. Configuration du catch-all
Configurez des mots de passe catch-all pour les domaines qui doivent recevoir des emails Ă nâimporte quelle adresse. LâIA peut crĂ©er, lister, et gĂ©rer ces mots de passe pour vous.
18. Gestion des invitations de domaine
Invitez des membres de lâĂ©quipe Ă gĂ©rer les domaines, vĂ©rifiez les invitations en attente, et nettoyez celles expirĂ©es. Utile pour les organisations avec plusieurs administrateurs de domaine.
19. Test du stockage S3
Si vous utilisez un stockage S3 personnalisĂ© pour les sauvegardes dâemails, demandez Ă lâIA de tester la connexion et de vĂ©rifier que tout fonctionne correctement.
20. Composition de brouillons dâemail
CrĂ©ez des brouillons dâemails dans votre boĂźte sans les envoyer. Utile pour prĂ©parer des emails Ă relire avant envoi, ou pour construire des modĂšles dâemail. (NĂ©cessite les identifiants dâalias.)
Exemples de commandes
Voici des commandes que vous pouvez utiliser directement avec votre assistant IA :
Envoyer un email :
« Envoie un email de hello@mydomain.com Ă john@example.com avec pour objet âRĂ©union demainâ et pour corps âSalut John, on est toujours bon pour 14h ?â » Gestion de domaine :
"Listez tous mes domaines et dites-moi lesquels ont des enregistrements DNS non vérifiés."
Création d'alias :
"Créez un nouvel alias support@mydomain.com qui transfÚre vers mon email personnel."
Recherche dans la boßte de réception (nécessite les identifiants de l'alias) :
"Trouvez tous les emails non lus de la semaine derniĂšre qui mentionnent 'facture'."
Calendrier (nécessite les identifiants de l'alias) :
"Créez un calendrier appelé 'Travail' et ajoutez une réunion pour demain à 14h appelée 'Réunion d'équipe'."
Scripts Sieve :
"Ăcrivez un script Sieve pour info@mydomain.com qui rĂ©pond automatiquement aux emails par 'Merci de nous avoir contactĂ©s, nous vous rĂ©pondrons sous 24 heures.'"
Opérations en masse :
"Créez des alias pour sales@, support@, billing@, et info@ sur mydomain.com, tous redirigeant vers team@mydomain.com."
Vérification de sécurité :
"Vérifiez le statut de vérification DNS et SMTP pour tous mes domaines et dites-moi si quelque chose nécessite une attention."
Générer un mot de passe pour alias :
"Générez un mot de passe pour l'alias user@example.com afin que je puisse accéder à ma boßte de réception."
Variables d'environnement
| Variable | Obligatoire | Par défaut | Description |
|---|---|---|---|
FORWARD_EMAIL_API_KEY |
Oui | â | Votre clĂ© API Forward Email (utilisĂ©e comme nom d'utilisateur Basic auth pour les points d'API par clĂ©) |
FORWARD_EMAIL_ALIAS_USER |
Non | â | Adresse email de l'alias pour les points d'accĂšs Ă la boĂźte aux lettres (ex. user@example.com) |
FORWARD_EMAIL_ALIAS_PASSWORD |
Non | â | Mot de passe gĂ©nĂ©rĂ© pour l'alias pour les points d'accĂšs Ă la boĂźte aux lettres |
FORWARD_EMAIL_API_URL |
Non | https://api.forwardemail.net |
URL de base de l'API (pour auto-hébergement ou tests) |
Sécurité
Le serveur MCP s'exécute localement sur votre machine. Voici comment fonctionne la sécurité :
- Vos identifiants restent locaux. Votre clĂ© API et vos identifiants d'alias sont lus depuis des variables d'environnement et utilisĂ©s pour authentifier les requĂȘtes API via HTTP Basic auth. Ils ne sont jamais envoyĂ©s au modĂšle IA.
- Transport stdio. Le serveur communique avec le client IA via stdin/stdout. Aucun port réseau n'est ouvert.
- Aucune conservation des données. Le serveur est sans état. Il ne met pas en cache, ne journalise pas et ne stocke aucune donnée de vos emails.
- Open source. L'intégralité du code est disponible sur GitHub. Vous pouvez auditer chaque ligne.
Utilisation programmatique
Vous pouvez aussi utiliser le serveur comme une bibliothĂšque :
const { McpServer } = require('@forwardemail/mcp-server');
const server = new McpServer({
apiKey: 'your-api-key',
aliasUser: 'user@example.com',
aliasPassword: 'generated-alias-password',
});
server.listen();
Open Source
Le Forward Email MCP Server est open-source sur GitHub sous licence BUSL-1.1. Nous croyons en la transparence. Si vous trouvez un bug ou souhaitez une fonctionnalité, ouvrez une issue.