Work IQ Mail reference (preview)

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		 Work IQ Mail MCP server providing Microsoft Graph mail tools.

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