Outlook Mail MCP server for your AI

Run up to 20 read (GET) requests in one Microsoft Graph $batch, e.g. several messages by id: [{ "url": "/me/messages/ID1?$select=subject,from,bodyPreview" }, ...].

Create a draft message (nothing is sent).

Create a reply draft to the sender (nothing is sent), already threaded with the original.

Delete a message: it moves to Deleted Items (it can be recovered there).

Forward a message now.

Forward a message with extra files attached: creates the forward draft (the original's attachments come along), adds the files, then sends it, or leaves it as a draft with draftOnly.

Read a whole email thread, oldest first: each message's sender, recipients, date and its own new text (without the quoted history).

Read one message: sender, recipients, subject, the body (as plain text by default; bodyFormat html for HTML), dates, flags and the list of its attachments.

A quick look at the mailbox: Inbox unread and total counts, how many messages are flagged, the newest unread messages (compact), and whether automatic replies (out of office) are on.

List the messages in one folder.

List messages across the whole mailbox (every folder, newest first).

Move a message to another folder (archive it, file it, or move it out of Junk).

Move up to 50 messages to a folder in one call (archive them, file them, move them out of Junk).

Reply to the sender and every recipient now.

Reply to the sender now (threaded with the original, saved in Sent Items).

Reply (or reply all) to a message with files attached: creates the threaded reply draft, adds the files (any size up to 150 MB each), then sends it, or leaves it as a draft with draftOnly.

Find messages: by words (sender, subject and body), sender, recipient, subject, folder (name or path), date range, unread, flagged, attachments or importance.

Send a draft.

Send a new email (or save it as a draft with draftOnly: true), with attachments of any size up to 150 MB each: small ones go with the message, large ones are uploaded in parts.

Change a message: mark read or unread, flag it, set categories or importance, or edit a draft's subject, body and recipients.

Change up to 50 messages at once: mark read or unread, flag or complete, set or add categories (names from outlook_mail_list_categories), set importance.

Create a top-level mail folder.

Find a mail folder by name or path and get its id, path, unread and total counts.

One mail folder with its unreadItemCount, totalItemCount and childFolderCount.

List the subfolders of a mail folder.

List the top-level mail folders (Inbox, Drafts, Sent Items, Deleted Items, Archive, Junk Email and your own) with unreadItemCount and totalItemCount.

Create an Outlook contact.

One contact with every detail.

List the user's Outlook contacts (default contact folder): names, email addresses, phones, company.

Change a contact: send only the fields that change.

Attach a file under 3 MB (or another Outlook item, or a link) to a draft.

One attachment with its content: a file's contentBytes (base64), an attached message or event (with $expand=microsoft.graph.itemattachment/item), or a link.

List a message's attachments: id, name, contentType, size, isInline (file contents are left out).

Read an attachment: the text of documents (Word .docx, PowerPoint .pptx, Excel .xlsx, .txt, .csv, .html, .json, .ics), an attached email (its sender, subject and body), or an image (returned as the image).

Create an Inbox rule that files, flags, categorizes, deletes or forwards incoming mail.

Mailbox settings: automatic replies (out of office), time zone, language, date and time format, working hours, and the mailbox purpose (user or shared).

List the user's Outlook categories (name and color).

List the Inbox rules (what each one matches and does, in the order they run).

Turn automatic replies (out of office) on, off, or on for a period, with the reply text.

Change mailbox settings: automatic replies, time zone, language, date and time format, working hours.

The signed-in user's profile: displayName, mail, userPrincipalName, id, jobTitle, preferredLanguage.

Find people the user works or corresponds with, ranked by relevance: colleagues, frequent contacts and saved contacts.

Copy a message to another folder; returns the copy.

Count the messages in a folder; with $filter=isRead eq false, the unread ones.

Count messages across the mailbox; with $filter (e.g. isRead eq false) counts only matching ones.

Create a draft from a complete MIME message (an .eml), base64-encoded.

Create a message in a specific folder (a draft unless the folder is not Drafts, which files a copy there).

Create a draft that forwards the message (nothing is sent).

Create a reply-all draft (nothing is sent).

Before sending, check recipients: automatic replies (out of office), full mailboxes, external recipients, moderation, delivery restrictions, maximum message size.

The message as raw MIME (RFC 822 text, the .eml format), with every header.

Messages added, changed or deleted in one folder since the last call (change tracking).

Delete a message for good (it skips Deleted Items and cannot be restored by the user).

Send a new message in Graph's own shape { message, saveToSentItems }.

Send a complete MIME message (an .eml), base64-encoded.

Count the folders inside a contact folder.

Count the contact folders.

Count the contacts in one contact folder.

Create a folder inside a contact folder.

Create a contact folder.

Create a contact in a specific contact folder.

Delete a contact folder and its contacts.

One contact folder.

List the folders inside a contact folder.

Contact folders added, changed or removed since the last call; pass the @odata.deltaLink as cursor next time.

List the contact folders.

Contacts added, changed or removed in one contact folder since the last call; pass the @odata.deltaLink as cursor next time.

List the contacts in one contact folder.

Delete a contact folder and its contacts for good.

Rename a contact folder.

Copy a folder (with its contents) into another folder.

Count the subfolders of a mail folder.

Count the top-level mail folders.

Create a folder inside another folder, or a search folder.

Delete a mail folder and everything in it (it moves to Deleted Items).

Folders added, changed or removed since the last call (change tracking).

Move a folder (with its contents) into another folder.

Delete a folder and its contents for good (they skip Deleted Items).

Rename a mail folder.

Count the open extensions on a contact.

Count the open extensions on a message.

Store custom app data on a contact as an open extension.

Store custom app data on a message as an open extension.

Remove an open extension from a contact.

Remove an open extension from a message.

Read one open extension on a contact.

Read one open extension on a message.

List the open extensions (custom app data) on a contact.

List the open extensions (custom app data) stored on a message.

Change the data of an open extension on a contact.

Change the data of an open extension on a message.

Count the contacts in the default contact folder.

Delete a contact (it moves to Deleted Items).

A contact's photo, returned as an image.

A contact photo's size and type.

Delete a contact for good.

Upload a contact's photo (JPEG or PNG, base64).

Count a message's attachments (inline images included).

Start uploading a file of 3 MB to 150 MB to a draft.

Remove an attachment from a draft.

The raw content of an attachment: a file's bytes, or an attached message as MIME (.eml) text.

Count the user's Outlook categories.

Count the Focused Inbox sender overrides.

Count the Inbox rules.

Create an Outlook category with a color.

Always put a sender's mail in Focused (or in Other).

Ask Microsoft to call an HTTPS webhook when mail or contacts change (new message in the Inbox, for example).

Delete an Outlook category from the list (messages keep the name as plain text).

Remove a sender override (Outlook goes back to sorting that sender itself).

Delete an Inbox rule.

Stop a change-notification subscription.

One Outlook category.

One Focused Inbox sender override.

One Inbox rule.

One change-notification subscription.

List the senders whose mail always goes to Focused or to Other in the Focused Inbox.

List the change-notification subscriptions this app holds for the signed-in user.

The languages the mailbox supports (locale codes for mailbox settings).

The time zones the mailbox supports (Windows names), for mailbox settings and automatic replies.

The supported time zones in one naming standard: timeZoneStandard Windows or Iana.

Reauthorize a subscription after Microsoft sent a reauthorizationRequired lifecycle notification.

Extend a subscription (new expirationDateTime, at most 10,080 minutes ahead for Outlook) or change its notificationUrl.

Change a category's color (its name cannot be changed).

Switch a sender override between Focused and Other.

Change an Inbox rule: rename it, turn it on or off, change its order, conditions or actions.

Convert Outlook item ids between formats (Graph REST ids, immutable ids, EWS ids, entry ids), up to 1000 at once.