Share via

Microsoft Mail MCP server reference

Important

You need to be part of the Frontier preview program to get early access to Microsoft Agent 365. Frontier connects you directly with Microsoft’s latest AI innovations. Frontier previews are subject to the existing preview terms of your customer agreements. As these features are still in development, their availability and capabilities may change over time.

Overview

Server ID Display name Description
mcp_MailTools Microsoft Outlook Mail MCP Server MCP server providing Microsoft Graph Mail tools.

Available tools

1. mcp_MailTools_graph_mail_createMessage

Create a draft email. Supports HTML by setting body.body.contentType = "HTML".

Required parameters:

  • subject: Message subject
  • toRecipients: Array of recipients with email addresses
  • body: Message body with contentType (Text/HTML) and content

Optional parameters:

  • preferHtml: Set to true for HTML content
  • headers: Optional additional headers

mcp_MailTools_graph_mail_deleteMessage

Delete a message from the signed-in user's mailbox.

Required parameters:

  • id: Message ID

Optional parameters:

  • If-Match: Optional ETag for concurrency control

mcp_MailTools_graph_mail_getMessage

Get a message by ID from the signed-in user's mailbox. Use preferHtml to request HTML body.

Required parameters:

  • id: Message ID

Optional parameters:

  • select: OData select clause
  • expand: OData expand clause
  • preferHtml: Request HTML body format
  • headers: Optional HTTP headers

mcp_MailTools_graph_mail_listSent

List messages in Sent Items.

Optional parameters:

  • filter: OData filter
  • search: Search query
  • orderby: Sort expression
  • top: Number of items to return
  • select: Fields to return

mcp_MailTools_graph_mail_reply

Send a reply to an existing message. Supports HTML via preferHtml or headers.

Required parameters:

  • id: Message ID to reply to

Optional parameters:

  • comment: Reply text
  • message: Optional message overrides
  • preferHtml: Enable HTML formatting
  • headers: Optional HTTP headers

mcp_MailTools_graph_mail_replyAll

Send a reply-all to an existing message. Supports HTML via preferHtml or headers.

Required parameters:

  • id: Message ID to reply-all to

Optional parameters:

  • comment: Reply text
  • message: Optional message overrides
  • preferHtml: Enable HTML formatting
  • headers: Optional HTTP headers

mcp_MailTools_graph_mail_searchMessages

Search Outlook messages using Microsoft Graph Search API with KQL-style queries.

Required parameters:

  • requests: Array of search requests with entityTypes, query, from, size parameters

Supports searching message content, subject, body, and attachments

mcp_MailTools_graph_mail_sendDraft

Send an existing draft message by ID.

Required parameters:

  • id: Draft message ID to send

mcp_MailTools_graph_mail_sendMail

Send an email as the signed-in user.

Required parameters:

  • message: Message object with subject, toRecipients, and body
  • subject: Email subject
  • toRecipients: Primary recipients
  • body: Email body with contentType (Text/HTML) and content

Optional parameters:

  • ccRecipients: Carbon-copy recipients
  • bccRecipients: Blind carbon-copy recipients
  • saveToSentItems: Save to Sent Items (default: true)
  • preferHtml: Force HTML rendering
  • headers: Optional additional HTTP headers

10. mcp_MailTools_graph_mail_updateMessage

Update a message's mutable properties (for example, subject, body, categories).

Required parameters:

  • id: Message ID

Optional parameters:

  • subject: New subject
  • body: New message body
  • categories: Message categories
  • importance: Low, Normal, or High
  • If-Match: ETag for concurrency control

Key features

Email composition

  • Create draft and send emails
  • HTML and plain text support
  • To, CC, and BCC recipients
  • Rich formatting options

Email management

  • Get, update, and delete messages
  • Reply and reply-all functionality
  • Draft management
  • Category and importance settings

Search and filtering

  • KQL-style message search
  • OData query support
  • Search across subject, body, attachments
  • Pagination and filtering

Sentitems

  • List sent messages
  • Optional save to Sent Items
  • Filter and search sent items

Notes

  1. All operations use Microsoft Graph Mail API
  2. HTML content requires contentType = "HTML" in body
  3. preferHtml header requests HTML body format
  4. Search uses Microsoft Graph Search API with KQL queries
  5. Draft messages can be created, updated, and sent separately
  6. ETag support for concurrency control on updates
  • Last updated on