Mail reference (preview)

Note

Features in this article are powered by the standard harness, which uses the billing options described in Licensing for agents powered by the standard harness. Learn how to access standard features in Access standard agents and agent flows.

Important

This is a preview feature.

  • Microsoft releases preview features before an official release so that customers can get early access and provide feedback.
  • Preview features have restricted functionality and aren't meant for production use.
  • Microsoft might change preview MCP tool names and parameters. Avoid hard-coded dependencies. Microsoft maintains scenario support.
  • Preview features are subject to Microsoft supplemental terms of use.

Overview

Server ID Tenant-level URL Display name Description
mcp_MailTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_MailTools		 Mail Tools for Microsoft Graph mail operations, including creating, sending, replying, and managing email messages.

Available tools

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

Deletes 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

Gets 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 keyword query language (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

Updates a message's mutable properties, such as the subject, body, and 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 drafts 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, and attachments.
  • Pagination and filtering.

Sentitems

  • List sent messages.
  • Optional save to sent items.
  • Filter and search sent items.

Notes

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