ovh-exchange-mcp

Serveur MCP (Model Context Protocol) qui expose une boîte Exchange (EWS, authentification NTLM) à un agent IA — recherche, lecture, envoi, réponse, transfert d'emails, gestion des dossiers et pièces jointes.

Configuration

Copier .env.example en .env et remplir les variables :

EWS_URL=https://ex2.mail.ovh.net/EWS/Exchange.asmx
EWS_USERNAME=votre.adresse@domaine.fr
EWS_PASSWORD=votre_mot_de_passe
EWS_DOMAIN=

• EWS_USERNAME : l'adresse email complète (pas juste le login).

• EWS_DOMAIN : laisser vide sauf si le serveur exige un domaine Windows explicite.

Installer les dépendances :

npm install

Connexion à Claude Desktop

Ajouter dans claude_desktop_config.json (menu Claude Desktop > Settings > Developer > Edit Config) :

{
  "mcpServers": {
    "ovh-exchange": {
      "command": "node",
      "args": ["/chemin/absolu/vers/ovh-exchange-mcp/index.js"],
      "env": {
        "EWS_URL": "https://ex2.mail.ovh.net/EWS/Exchange.asmx",
        "EWS_USERNAME": "votre.adresse@domaine.fr",
        "EWS_PASSWORD": "votre_mot_de_passe",
        "EWS_DOMAIN": ""
      }
    }
  }
}

Redémarrer Claude Desktop. Les 8 tools doivent apparaître dans la liste des outils disponibles.

Test manuel

node test-manual.js search
node test-manual.js get <itemId>
node test-manual.js folders
node test-manual.js update <itemId>
node test-manual.js attachments <itemId> [attachmentId]
node test-manual.js reply <itemId>
node test-manual.js forward <itemId> <destinataire>
node test-manual.js send <destinataire>

Ajouter DEBUG_EWS=1 devant la commande pour afficher la requête SOAP envoyée.

Tools disponibles

search_emails(folder, query?, maxResults?)

Liste les emails d'un dossier.

{ "folder": "inbox", "query": "subject:facture", "maxResults": 10 }

get_email(itemId)

Récupère le contenu complet d'un email (corps HTML, destinataires, pièces jointes).

{ "itemId": "AQMkAD..." }

send_email(to, subject, body, cc?)

Action irréversible — envoie réellement un email.

{ "to": "quelqu'un@exemple.fr", "subject": "Bonjour", "body": "<p>Contenu</p>" }

list_folders()

Énumère tous les dossiers de la boîte mail avec leur nombre d'emails non lus.

{}

update_email(itemId, markAsRead?, moveToFolder?)

Marque comme lu/non lu et/ou déplace vers un autre dossier (par nom d'affichage ou nom standard).

{ "itemId": "AQMkAD...", "markAsRead": true, "moveToFolder": "Archive" }

get_attachments(itemId, attachmentId?)

Sans attachmentId : liste les pièces jointes. Avec : télécharge le contenu en base64.

{ "itemId": "AQMkAD..." }
{ "itemId": "AQMkAD...", "attachmentId": "AAMkAD..." }

reply_to_email(itemId, body, replyAll?)

Action irréversible — envoie réellement une réponse.

{ "itemId": "AQMkAD...", "body": "<p>Merci, c'est noté.</p>", "replyAll": false }

forward_email(itemId, to, comment?)

Action irréversible — transfère réellement l'email.

{ "itemId": "AQMkAD...", "to": "collegue@exemple.fr", "comment": "Pour info" }

Notes

• Les tools send_email, reply_to_email et forward_email sont marqués comme irréversibles dans leur description : un agent IA bien élevé doit demander confirmation du destinataire et du contenu avant de les appeler.

• La vulnérabilité npm underscore (dépendance transitive de httpntlm) est corrigée via le champ overrides du package.json, sans changer de version de httpntlm.