Référence serveur Microsoft Mail MCP

Important

Vous devez faire partie du programme Frontier en version préliminaire pour obtenir un accès anticipé à Microsoft Agent 365. Frontier vous connecte directement aux dernières innovations d’IA de Microsoft. Les versions préliminaires Frontier sont soumises aux conditions existantes de vos contrats clients qui régissent les versions préliminaires. Comme ces fonctionnalités sont encore en cours de développement, leur disponibilité et leurs capacités peuvent évoluer au fil du temps.

Vue d’ensemble

ID du serveur	Nom d’affichage	Description
mcp_MailTools	Serveur MCP de mails Microsoft Outlook	Serveur MCP fournissant des outils de messagerie Microsoft Graph.

Outils disponibles

mcp_MailTools_graph_mail_createMessage

Créer un brouillon de courrier électronique. Prend en charge le HTML en définissant body.body.contentType = "HTML".

Paramètres obligatoires :

• subject : objet du message
• toRecipients : tableau de destinataires avec des adresses e-mail
• body : corps du message avec contentType (Text/HTML) et contenu

Paramètres facultatifs :

• preferHtml : défini sur true pour le contenu HTML
• headers : en-têtes supplémentaires facultatifs

mcp_MailTools_graph_mail_deleteMessage

Supprime un message de la boîte aux lettres de l’utilisateur connecté.

Paramètres obligatoires :

• id : ID de message

Paramètres facultatifs :

• Correspondance en cas de réponse : Optionnel ETag pour le contrôle de la concurrence

mcp_MailTools_graph_mail_getMessage

Récupère un message par ID à partir de la boîte aux lettres de l’utilisateur connecté. À utiliser preferHtml pour demander le corps du HTML.

Paramètres obligatoires :

• id : ID de message

Paramètres facultatifs :

• select : clause OData select
• expand : clause OData expand
• preferHtml : corps de requête au format HTML
• headers : en-têtes HTTP facultatifs

mcp_MailTools_graph_mail_listSent

Listez les messages dans les éléments envoyés.

Paramètres facultatifs :

• filter : filtre OData
• search : requête de recherche
• orderby : expression de tri
• top : nombre d’éléments à retourner
• select: champs à retourner

mcp_MailTools_graph_mail_reply

Envoyer une réponse à un message existant. Prend en charge le format HTML via preferHtml ou headers.

Paramètres obligatoires :

• id : ID du message auquel répondre

Paramètres facultatifs :

• comment : texte de réponse
• message : remplacements de message facultatifs
• preferHtml : activer la mise en forme HTML
• headers : en-têtes HTTP facultatifs

mcp_MailTools_graph_mail_replyAll

Envoyer une réponse à tous pour un message existant. Prend en charge le format HTML via preferHtml ou headers.

Paramètres obligatoires :

• id : ID du message auquel répondre à tous

Paramètres facultatifs :

• comment : texte de réponse
• message : remplacements de message facultatifs
• preferHtml : activer la mise en forme HTML
• headers : en-têtes HTTP facultatifs

mcp_MailTools_graph_mail_searchMessages

Recherchez des messages Outlook à l’aide de l’API Microsoft Graph Search avec des requêtes de type langage de requête par mots-clés (KQL).

Paramètres obligatoires :

• Demandes : Tableau de requêtes de recherche avec entityTypes, requête, from, paramètres de taille

Permet de rechercher dans le contenu des messages, l’objet, le corps et les pièces jointes

mcp_MailTools_graph_mail_sendDraft

Envoyer un message brouillon existant par ID.

Paramètres obligatoires :

• id : ID de message brouillon à envoyer

mcp_MailTools_graph_mail_sendMail

Envoyer un courrier électronique en tant qu’utilisateur connecté.

Paramètres obligatoires :

• Message: Objet message avec sujet, toRecipients, et corps
• subject : objet de l’e-mail
• toRecipients : destinataires principaux
• body : corps de courrier électronique avec contentType (Text/HTML) et contenu

Paramètres facultatifs :

• ccRecipients : destinataires en copie carbone
• bccRecipients : destinataires en copie cachée
• saveToSentItems : Enregistrer en objets envoyés (par défaut : true)
• preferHtml : forcer le rendu HTML
• headers : en-têtes HTTP supplémentaires facultatifs

10. mcp_MailTools_graph_mail_updateMessage

Mettre à jour les propriétés modifiables d’un message (par exemple : objet, corps, catégories).

Paramètres obligatoires :

• id : ID de message

Paramètres facultatifs :

• subject : nouvel objet
• body : nouveau corps du message
• categories : catégories de messages
• importance : Faible, Normal ou Élevée
• Correspondance en cas de réponse :ETag pour le contrôle de la concurrence

Fonctionnalités clés

Composition de l’e-mail

• Créer un brouillon et envoyer des e-mails
• Prise en charge du texte brut et HTML
• Destinataires À, CC et CCI
• Options de mise en forme avancées

Gestion du courrier électronique

• Obtenir, mettre à jour et supprimer des messages
• Fonctionnalité répondre et répondre à tous
• Gestion des brouillons
• Paramètres de catégorie et d’importance

Recherche et filtrage

• Recherche de messages de type KQL
• Prise en charge des requêtes OData
• Rechercher dans l’objet, le corps et les pièces jointes
• Pagination et filtrage

Sentitems

• Répertorier les messages envoyés
• Sauvegarde optionnelle aux objets envoyés
• Filtrer et rechercher des éléments envoyés

Notes

• Toutes les opérations utilisent l’API Mail de Microsoft Graph
• Le contenu HTML nécessite contentType = « HTML » dans le corps
• preferHtml Demande le format du corps HTML de l’en-tête
• La recherche utilise l’API Mail de Microsoft Graph avec des requêtes KQL
• Les brouillons de messages peuvent être créés, mis à jour et envoyés séparément
• ETag Prise en charge du contrôle de la concurrence lors des mises à jour