Référence du serveur MCP Microsoft Mail

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 Microsoft Outlook Mail	Serveur MCP fournissant des outils Microsoft Graph Mail.

Outils disponibles

1. mcp_MailTools_graph_mail_createMessage

Créer un brouillon de courrier électronique. Prend en charge le format 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 :

• If-Match : ETag facultatif 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é. Utilisez preferHtml pour demander le corps 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

Répertorier 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

Rechercher des messages Outlook à l’aide de l’API Microsoft Graph Search avec des requêtes de type KQL.

Paramètres obligatoires :

• requests : tableau de requêtes de recherche contenant les paramètres entityTypes, query, from et size

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 du message contenant subject, toRecipients et body
• 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 dans les éléments envoyés (valeur 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
• If-Match : 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
• Enregistrement facultatif dans Éléments envoyés
• Filtrer et rechercher des éléments envoyés

Notes

1. Toutes les opérations utilisent l’API Mail de Microsoft Graph
2. Le contenu HTML nécessite contentType = « HTML » dans le corps
3. L’en-tête preferHtml demande un format de corps HTML
4. La recherche utilise l’API Mail de Microsoft Graph avec des requêtes KQL
5. Les brouillons de messages peuvent être créés, mis à jour et envoyés séparément
6. Prise en charge d’ETag pour le contrôle de concurrence lors des mises à jour