Microsoft Outlook Mail
How to configure the Microsoft Outlook Mail MCP connector
The Microsoft Outlook Mail connector allows the chatbot to read, send, and manage emails through Microsoft Graph API using the ms-365-mcp-server.
Connector Settings
| Field | Value |
|---|---|
| Integration Type | MCP |
| Name | Microsoft Outlook Mail |
| URL | https://ms365-mail.mcp.mitigate.dev/mcp |
| Transport Type | Streamable HTTP |
| Authentication Type | OAuth 2.1 |
| OAuth Scopes | openid profile offline_access Mail.ReadWrite Mail.Send Mail.Read.Shared Mail.Send.Shared |
This MCP server supports Dynamic Client Registration (RFC 7591) — OAuth Client ID and Client Secret are not required.
A tenant admin must grant admin consent for the Mitigate AI Platform application before users can connect.
Application ID: bc2b3dde-4f74-483d-93c0-919c4b804b48
Use this direct link to grant consent: Grant admin consent
Or follow the manual steps:
- Sign in to the Microsoft Entra admin center as at least a Cloud Application Administrator.
- Browse to Identity → Applications → Enterprise applications → All applications.
- Search for Mitigate AI Platform and select it.
- Select Permissions under Security.
- Review the permissions and select Grant admin consent.
OAuth Scopes
See all available scopes in the Microsoft Graph permissions reference.
| Scope | Description |
|---|---|
openid | Enables OpenID Connect sign-in |
profile | Access to the user's basic profile information |
offline_access | Allows token refresh without re-prompting the user |
Mail.Read | Read the user's mail |
Mail.ReadWrite | Read and write access to the user's mail (includes Mail.Read) |
Mail.Send | Send mail on behalf of the user |
Mail.Read.Shared | Read mail in shared mailboxes |
Mail.Send.Shared | Send mail from shared mailboxes |
Workflow Trigger
The Microsoft Outlook Mail connector can be used as a workflow trigger. When configured, workflows automatically run when new emails arrive in the connected Outlook inbox.
Usage Examples
Once connected, users can interact with Outlook Mail through natural language:
- "Show my unread emails"
- "Send an email to john@example.com about the project update"
- "Search my inbox for emails from the marketing team"
- "Draft a reply to the latest email from my manager"
Tools
List Mail Messages
list-mail-messages
Get the messages in the signed-in user's mailbox.
Parameters:
- search - Search items by search phrases
Get Mail Message
get-mail-message
Get the properties and relationships of a specific message.
Parameters:
- messageId - The ID of the message
List Mail Folders
list-mail-folders
Get the mail folder collection directly under the root folder of the signed-in user.
List Mail Child Folders
list-mail-child-folders
Get the folder collection under the specified folder.
Parameters:
- mailFolderId - The ID of the mail folder
List Mail Folder Messages
list-mail-folder-messages
Get all the messages in the specified folder in the mailbox.
Parameters:
- mailFolderId - The ID of the mail folder
- search - Search items by search phrases
Send Mail
send-mail
Send the message specified in the request body. Saves the message in the Sent Items folder.
Parameters:
- body - The message to send
Create Draft Email
create-draft-email
Create a new draft message.
Parameters:
- body - The draft message object
Send Draft Message
send-draft-message
Send an existing draft message. Saves the message in the Sent Items folder.
Parameters:
- messageId - The ID of the draft message to send
Update Mail Message
update-mail-message
Update the properties of a message.
Parameters:
- messageId - The ID of the message to update
- body - The updated message properties
Delete Mail Message
delete-mail-message
Delete a message.
Parameters:
- messageId - The ID of the message to delete
Reply Mail Message
reply-mail-message
Reply to the sender of a message. Saves the reply in the Sent Items folder.
Parameters:
- messageId - The ID of the message to reply to
- body - The reply content
Reply All Mail Message
reply-all-mail-message
Reply to all recipients of a message. Saves the reply in the Sent Items folder.
Parameters:
- messageId - The ID of the message to reply to
- body - The reply content
Create Reply Draft
create-reply-draft
Create a draft to reply to the sender of a message.
Parameters:
- messageId - The ID of the message to reply to
- body - Optional reply content
Create Reply All Draft
create-reply-all-draft
Create a draft to reply to the sender and all recipients of a message.
Parameters:
- messageId - The ID of the message to reply to
- body - Optional reply content
Forward Mail Message
forward-mail-message
Forward a message. Saves the message in the Sent Items folder.
Parameters:
- messageId - The ID of the message to forward
- body - The forward content including recipients
Create Forward Draft
create-forward-draft
Create a draft to forward an existing message.
Parameters:
- messageId - The ID of the message to forward
- body - Optional forward content
Move Mail Message
move-mail-message
Move a message to another folder within the user's mailbox.
Parameters:
- messageId - The ID of the message to move
- body - The destination folder ID
List Mail Attachments
list-mail-attachments
Retrieve a list of attachment objects for a message.
Parameters:
- messageId - The ID of the message
Get Mail Attachment
get-mail-attachment
Read the properties or raw contents of an attachment.
Parameters:
- messageId - The ID of the message
- attachmentId - The ID of the attachment
Add Mail Attachment
add-mail-attachment
Add an attachment to a message.
Parameters:
- messageId - The ID of the message
- body - The attachment object
Delete Mail Attachment
delete-mail-attachment
Delete an attachment from a message.
Parameters:
- messageId - The ID of the message
- attachmentId - The ID of the attachment to delete
List Shared Mailbox Messages
list-shared-mailbox-messages
The messages in a shared mailbox.
Parameters:
- userId - The ID of the shared mailbox user
- search - Search items by search phrases
Get Shared Mailbox Message
get-shared-mailbox-message
Get a specific message from a shared mailbox.
Parameters:
- userId - The ID of the shared mailbox user
- messageId - The ID of the message
List Shared Mailbox Folder Messages
list-shared-mailbox-folder-messages
The collection of messages in a shared mailbox folder.
Parameters:
- userId - The ID of the shared mailbox user
- mailFolderId - The ID of the mail folder
- search - Search items by search phrases
Send Shared Mailbox Mail
send-shared-mailbox-mail
Send a message from a shared mailbox.
Parameters:
- userId - The ID of the shared mailbox user
- body - The message to send