Outlook
io.github.mcp-z/mcp-outlook
51 toolsauthSTDIO, HTTPregistry active
Summary
Connects Claude to Microsoft 365 mailboxes through the Graph API with proper OAuth flows. You get message search with query syntax, read/send operations, replies, category management, and bulk CSV exports. Ships with stdio for local use or HTTP for remote deployment. Supports three auth modes: standard loopback OAuth for desktop clients, device code flow for headless environments, and DCR for self-hosted setups with public endpoints. Includes prompts for email drafting and query syntax help. Reach for this when you need Claude to read your inbox, manage emails programmatically, or handle routine Outlook tasks without switching contexts.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Public tool metadata for what this MCP can expose to an agent.
51 tools
OUTLOOK_ADD_EVENT_ATTACHMENTAdds an attachment to a specific Outlook calendar event. Use when you need to attach a file or nested item to an existing event.6 params
Adds an attachment to a specific Outlook calendar event. Use when you need to attach a file or nested item to an existing event.
Parameters* required
contentBytesstringBase64-encoded file contents; required when '@odata.type' is fileAttachment.
event_idstringThe unique identifier of the calendar event to which the attachment will be added.
itemobjectThe nested item payload; required when '@odata.type' is itemAttachment.
namestringThe display name of the attachment.
odata_typestringAttachment type: '#microsoft.graph.fileAttachment' requires 'contentBytes'; '#microsoft.graph.itemAttachment' requires 'item'.one of
#microsoft.graph.fileAttachment · #microsoft.graph.itemAttachmentuser_idstringThe user's email address or 'me' for the authenticated user.default: me
OUTLOOK_ADD_MAIL_ATTACHMENTTool to add an attachment to an email message. Use when you have a message ID and need to attach a small (<3 MB) file or reference.10 params
Tool to add an attachment to an email message. Use when you have a message ID and need to attach a small (<3 MB) file or reference.
Parameters* required
contentBytesstringBase64-encoded content of the file attachment (max size 3 MB).
contentIdstringContent ID for inline attachments, used in HTML body references.
contentLocationstringURL location or path for reference attachments.
contentTypestringMIME type of the attachment (e.g., 'application/pdf').
isInlinebooleanSet to true if the attachment should appear inline in the message body.
itemobjectEmbedded item (e.g., message, event) for itemAttachment; must include its own '@odata.type'.
message_idstringUnique identifier of the email message to attach to.
namestringDisplay name of the attachment (e.g., file name).
odata_typestringThe OData type of the attachment. For file attachments, use '#microsoft.graph.fileAttachment'.
user_idstringThe user's principal name or 'me' for the authenticated user.default: me
OUTLOOK_CALENDAR_CREATE_EVENTCreates a new Outlook calendar event, ensuring `start_datetime` is chronologically before `end_datetime`.13 params
Creates a new Outlook calendar event, ensuring `start_datetime` is chronologically before `end_datetime`.
Parameters* required
attendees_infoarrayA list of attendees for the event. Each attendee object requires an 'email'. 'name' and 'type' ('required', 'optional', 'resource') are optional.
bodystringThe body of the event. This can be in plain text or HTML format, as specified by the 'is_html' field.
categoriesarrayA list of categories associated with the event. These categories must already exist in the user's mailbox.
end_datetimestringThe end date and time of the event in ISO 8601 format. Time zone is specified in 'time_zone'.
is_htmlbooleanSpecifies whether the 'body' content is HTML. Set to true for HTML content; otherwise, it's treated as plain text.default: false
is_online_meetingbooleanSet to true to indicate that the event is an online meeting. This will automatically generate an online meeting link if 'online_meeting_provider' is set (e.g., a Microsoft Teams link).default: false
locationstringThe physical location of the event.default:
online_meeting_providerstringSpecifies the online meeting provider. Currently, only 'teamsForBusiness' is supported. If 'is_online_meeting' is true and this is set, a meeting link for the provider will be created.
show_asstringThe status to show on the calendar for the duration of the event. Valid values are: 'free', 'tentative', 'busy', 'oof' (out of office), 'workingElsewhere', 'unknown'.default: busy
start_datetimestringThe start date and time of the event in ISO 8601 format. Time zone is specified in 'time_zone'.
subjectstringThe subject of the calendar event.
time_zonestringThe time zone for the start and end times of the event. Uses Windows time zone names (e.g., 'Pacific Standard Time') or IANA time zone names (e.g., 'America/Los_Angeles'). UTC is also a valid input.
user_idstringThe UPN (User Principal Name) or object ID of the user whose calendar the event will be created in. Use 'me' for the currently authenticated user.default: me
OUTLOOK_CREATE_ATTACHMENT_UPLOAD_SESSIONTool to create an upload session for large (>3 MB) message attachments. Use when you need to upload attachments in chunks.3 params
Tool to create an upload session for large (>3 MB) message attachments. Use when you need to upload attachments in chunks.
Parameters* required
attachmentItemobjectAttachmentItem object describing the attachment in the upload session.
message_idstringThe unique identifier of the message to attach to.
user_idstringUser ID or user principal name; use 'me' for the signed-in user.default: me
OUTLOOK_CREATE_CALENDARTool to create a new calendar in the signed-in user's mailbox. Use when organizing events into a separate calendar.4 params
Tool to create a new calendar in the signed-in user's mailbox. Use when organizing events into a separate calendar.
Parameters* required
colorstringThe theme color to assign to the calendar. Supported values: auto, lightBlue, lightGreen, lightOrange, lightGray, lightYellow, lightTeal, lightPink, lightBrown, lightPurple, lightRed.one of
auto · lightBlue · lightGreen · lightOrange · lightGray · lightYellowhexColorstringAn optional hexadecimal color code for the calendar in the format '#RRGGBB'.
namestringThe display name of the new calendar.
user_idstringThe UPN (User Principal Name) or object ID of the user where the calendar will be created. Use 'me' for the signed-in user.default: me
OUTLOOK_CREATE_CONTACTCreates a new contact in a Microsoft Outlook user's contacts folder.15 params
Creates a new contact in a Microsoft Outlook user's contacts folder.
Parameters* required
birthdaystringThe contact's birthday in 'YYYY-MM-DD' format. The time component will be set to midnight UTC (e.g., '1990-01-01' becomes '1990-01-01T00:00:00Z' in the API request).default:
businessPhonesarrayA list of business phone numbers for the contact. Each number should be a string.
categoriesarrayA list of categories to assign to the contact.
companyNamestringThe name of the company the contact is associated with.default:
departmentstringThe department the contact belongs to within their company.default:
displayNamestringThe contact's display name, typically their full name.default:
emailAddressesarrayA list of email addresses for the contact.
givenNamestringThe contact's given (first) name.default:
homePhonestringThe contact's home phone number. If provided, this will be stored in Outlook as a list containing this single number.default:
jobTitlestringThe contact's job title.default:
mobilePhonestringThe contact's mobile phone number.default:
notesstringPersonal notes about the contact. These notes are stored as 'personalNotes' in the Outlook contact details.default:
officeLocationstringThe contact's office location.default:
surnamestringThe contact's surname (last name).default:
user_idstringIdentifier for the user whose contact list will be modified. Use 'me' for the authenticated user, or provide the user's principal name (e.g., 'user@example.com').default: me
OUTLOOK_CREATE_CONTACT_FOLDERTool to create a new contact folder in the user's mailbox. Use when needing to organize contacts into custom folders.3 params
Tool to create a new contact folder in the user's mailbox. Use when needing to organize contacts into custom folders.
Parameters* required
displayNamestringThe display name of the new contact folder.
parentFolderIdstringThe ID of the parent contact folder. If omitted, created under the default contacts folder.
user_idstringThe user's principal name or object ID. Use 'me' for the authenticated user.default: me
OUTLOOK_CREATE_DRAFTCreates an Outlook email draft with subject, body, recipients, and an optional attachment. Supports creating drafts as part of existing conversation threads by specifying a conversationId; attachments require a name, mimetype, and content.8 params
Creates an Outlook email draft with subject, body, recipients, and an optional attachment. Supports creating drafts as part of existing conversation threads by specifying a conversationId; attachments require a name, mimetype, and content.
Parameters* required
attachmentstringOptional file to attach. If provided, must include the file's content, name, and mimetype.
bcc_recipientsarrayOptional list of BCC (blind carbon copy) recipient email addresses.
bodystringContent of the email draft; use `is_html` to specify if HTML or plain text.
cc_recipientsarrayOptional list of CC (carbon copy) recipient email addresses.
conversation_idstringOptional conversation ID to create the draft as part of an existing email conversation thread. If provided, the draft will be part of the specified conversation instead of starting a new one.
is_htmlbooleanSpecifies if the `body` is HTML. If `False`, `body` is plain text.default: false
subjectstringSubject line for the email draft.
to_recipientsarrayList of primary 'To' recipient email addresses.
OUTLOOK_CREATE_DRAFT_REPLYCreates a draft reply in the specified user's Outlook mailbox to an existing message (identified by a valid `message_id`), optionally including a `comment` and CC/BCC recipients.5 params
Creates a draft reply in the specified user's Outlook mailbox to an existing message (identified by a valid `message_id`), optionally including a `comment` and CC/BCC recipients.
Parameters* required
bcc_emailsarrayList of email addresses to add as BCC recipients to the draft reply.
cc_emailsarrayList of email addresses to add as CC recipients to the draft reply.
commentstringPlain text comment to include in the body of the reply draft.
message_idstringUnique ID of the message to reply to, typically obtained from actions like 'List Messages' or 'Get Message'.
user_idstringUser's mailbox identifier (email or 'me') for the original message and new draft location.default: me
OUTLOOK_CREATE_EMAIL_RULECreate email rule filter with conditions and actions5 params
Create email rule filter with conditions and actions
Parameters* required
actionsobjectActions to take when the rule conditions are met.
conditionsobjectConditions that must be met for the rule to apply.
displayNamestringDisplay name for the email rule.
isEnabledbooleanWhether the rule is enabled.default: true
sequenceintegerOrder in which the rule is executed (lower numbers execute first).default: 1
OUTLOOK_CREATE_MAIL_FOLDERTool to create a new mail folder. Use when you need to organize email into a new folder.3 params
Tool to create a new mail folder. Use when you need to organize email into a new folder.
Parameters* required
displayNamestringThe display name of the new mail folder.
isHiddenbooleanIndicates whether the new folder is hidden. Default is false. Once set, this property cannot be updated.default: false
user_idstringIdentifier for the user whose mailbox the folder will be created in. Use 'me' for the authenticated user or provide the user's principal name or ID.default: me
OUTLOOK_CREATE_MASTER_CATEGORYTool to create a new category in the user's master category list. Use after selecting a unique display name.2 params
Tool to create a new category in the user's master category list. Use after selecting a unique display name.
Parameters* required
colorstringA pre-set color constant for the category. Allowed values: preset0 through preset24.one of
preset0 · preset1 · preset2 · preset3 · preset4 · preset5displayNamestringUnique name that identifies the category in the user's mailbox.
OUTLOOK_DELETE_CONTACTPermanently deletes an existing contact, using its `contact_id` (obtainable via 'List User Contacts' or 'Get Contact'), from the Outlook contacts of the user specified by `user_id`.2 params
Permanently deletes an existing contact, using its `contact_id` (obtainable via 'List User Contacts' or 'Get Contact'), from the Outlook contacts of the user specified by `user_id`.
Parameters* required
contact_idstringIdentifier of the contact to be deleted, typically obtained from 'List User Contacts' or 'Get Contact'.
user_idstringThe UPN (User Principal Name) or ID of the user; use 'me' for the signed-in user.default: me
OUTLOOK_DELETE_EMAIL_RULEDelete an email rule1 params
Delete an email rule
Parameters* required
ruleIdstringID of the email rule to delete.
OUTLOOK_DELETE_EVENTDeletes an existing calendar event, identified by its unique `event_id`, from a specified user's Microsoft Outlook calendar, with an option to send cancellation notifications to attendees.3 params
Deletes an existing calendar event, identified by its unique `event_id`, from a specified user's Microsoft Outlook calendar, with an option to send cancellation notifications to attendees.
Parameters* required
event_idstringUnique identifier of the calendar event to delete, typically obtained from event listing or retrieval actions.
send_notificationsbooleanIf `True`, sends cancellation notifications to event attendees upon deletion.default: true
user_idstringUser's email address or 'me' for the current user.default: me
OUTLOOK_DELETE_MAIL_FOLDERDelete a mail folder from the user's mailbox. Use when you need to remove an existing mail folder.2 params
Delete a mail folder from the user's mailbox. Use when you need to remove an existing mail folder.
Parameters* required
folder_idstringThe unique identifier or well-known name of the mail folder to delete (e.g., folder ID or 'Drafts', 'SentItems').
user_idstringIdentifier for the user whose mailbox contains the folder to delete. Use 'me' for the authenticated user or provide the user's principal name or ID.default: me
OUTLOOK_DOWNLOAD_OUTLOOK_ATTACHMENTDownloads a specific file attachment from an email message in a Microsoft Outlook mailbox; the attachment must contain 'contentBytes' (binary data) and not be a link or embedded item.4 params
Downloads a specific file attachment from an email message in a Microsoft Outlook mailbox; the attachment must contain 'contentBytes' (binary data) and not be a link or embedded item.
Parameters* required
attachment_idstringThe unique identifier of the attachment to be downloaded. This ID is typically obtained from the message's details when an email message object is retrieved.
file_namestringThe desired filename for the downloaded attachment. This name will be assigned to the `FileDownloadable` object.
message_idstringThe unique identifier of the email message that contains the attachment to be downloaded. This ID is typically obtained when listing or retrieving messages.
user_idstringThe user's UPN (User Principal Name) or 'me' for the authenticated user. This identifies the mailbox where the message is located.default: me
OUTLOOK_GET_CALENDAR_VIEWGet events ACTIVE during a time window (includes multi-day events). Use for "what's on my calendar today/this week" or availability checks. Returns events overlapping the time range. For keyword search or filters by category, use OUTLOOK_LIST_EVENTS instead.7 params
Get events ACTIVE during a time window (includes multi-day events). Use for "what's on my calendar today/this week" or availability checks. Returns events overlapping the time range. For keyword search or filters by category, use OUTLOOK_LIST_EVENTS instead.
Parameters* required
calendar_idstringOptional ID of a specific calendar to query. If not provided, uses the primary calendar. Get calendar IDs using LIST_CALENDARS action.
end_datetimestringEnd of the time window in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ). Events active during this window will be returned.
selectarrayList of specific event properties to return (e.g., ['subject', 'start', 'end']). If omitted, returns default properties.
start_datetimestringStart of the time window in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ). Events active during this window will be returned.
timezonestringIANA or Windows timezone for event times (e.g., 'America/New_York'). Defaults to UTC.default: UTC
topintegerMaximum number of events to retrieve. Default is 100.default: 100
user_idstringEmail address of the target user (or 'me' for authenticated user).default: me
OUTLOOK_GET_CONTACTRetrieves a specific Outlook contact by its `contact_id` from the contacts of a specified `user_id` (defaults to 'me' for the authenticated user).2 params
Retrieves a specific Outlook contact by its `contact_id` from the contacts of a specified `user_id` (defaults to 'me' for the authenticated user).
Parameters* required
contact_idstringUnique identifier for the contact within the specified user's Outlook address book.
user_idstringUser's principal name (e.g., 'AdeleV@contoso.onmicrosoft.com') or 'me' for the authenticated user. Using 'me' is recommended for accessing one's own contacts.default: me
OUTLOOK_GET_CONTACT_FOLDERSTool to retrieve a list of contact folders in the signed-in user's mailbox. Use after authentication when you need to browse or select among contact folders.7 params
Tool to retrieve a list of contact folders in the signed-in user's mailbox. Use after authentication when you need to browse or select among contact folders.
Parameters* required
expandarrayRelated entities to expand inline, e.g., ['contacts'].
filterstringOData filter expression, e.g., startswith(displayName,'A').
orderbyarrayList of properties to order results by, e.g., ['displayName asc'].
selectarrayList of properties to include in the response, e.g., ['id','displayName'].
skipintegerNumber of contact folders to skip for pagination.
topintegerMaximum number of contact folders to return.
user_idstringUser principal name or ID. Use 'me' for the authenticated user.default: me
OUTLOOK_GET_EVENTRetrieves the full details of a specific calendar event by its ID from a user's Outlook calendar, provided the event exists.2 params
Retrieves the full details of a specific calendar event by its ID from a user's Outlook calendar, provided the event exists.
Parameters* required
event_idstringThe unique identifier of the calendar event to retrieve.
user_idstringThe user's primary SMTP address, user principal name (UPN), or the alias 'me' (for the signed-in user) to identify the calendar owner.default: me
OUTLOOK_GET_MAILBOX_SETTINGSTool to retrieve mailbox settings. Use when you need to view settings such as automatic replies, time zone, and working hours for the signed-in or specified user.3 params
Tool to retrieve mailbox settings. Use when you need to view settings such as automatic replies, time zone, and working hours for the signed-in or specified user.
Parameters* required
expandarrayOData $expand query to include related entities.
selectarrayOData $select query to specify mailbox settings properties to include.
user_idstringThe user's unique identifier or principal name. Use 'me' for the signed-in user.default: me
OUTLOOK_GET_MAIL_DELTARetrieve incremental changes (delta) of messages in a mailbox. FIRST RUN: Returns ALL messages in folder (use top=50 to limit). Response has @odata.deltaLink. SUBSEQUENT: Pass stored deltaLink to get only NEW/UPDATED/DELETED messages since last sync. Properties available: id,...7 params
Retrieve incremental changes (delta) of messages in a mailbox. FIRST RUN: Returns ALL messages in folder (use top=50 to limit). Response has @odata.deltaLink. SUBSEQUENT: Pass stored deltaLink to get only NEW/UPDATED/DELETED messages since last sync. Properties available: id,...
Parameters* required
delta_tokenstringDelta token from a previous call to get only changes since that state. If delta_token is not provided, the API returns all messages in the folder (initial sync). Use top parameter (e.g., top=50) on...
expandarrayList of related entities to expand (e.g. ['attachments']).
folder_idstringMail folder identifier to scope the delta query to that folder (e.g., 'Inbox' or folder ID GUID). Defaults to Inbox when omitted.
selectarrayList of message properties to include (e.g. ['subject','receivedDateTime']). Delta sync has property limitations due to response size constraints. Not available in delta: internetMessageHeaders, bo...
skip_tokenstringSkip token for paging through large result sets during initial sync. Automatically provided in response '@odata.nextLink' when there are more results. Extract from nextLink URL and pass here for ne...
topintegerMaximum number of items to return per page. For first run without delta_token, use top=50 or top=100 to limit results. First delta call without token returns all messages in folder. Paginate throug...
user_idstringUser identifier: 'me' for the signed-in user or the user's email/UPN.default: me
OUTLOOK_GET_MAIL_TIPSTool to retrieve mail tips such as automatic replies and mailbox full status. Use when you need to check recipient status before sending mail.3 params
Tool to retrieve mail tips such as automatic replies and mailbox full status. Use when you need to check recipient status before sending mail.
Parameters* required
EmailAddressesarrayCollection of SMTP addresses of recipients to get MailTips for.
MailTipsOptionsarrayList of mail tip types to retrieve for each recipient.
user_idstringUser principal name (UPN) or 'me' for the signed-in user.default: me
OUTLOOK_GET_MASTER_CATEGORIESTool to retrieve the user's master category list. Use when you need to get all categories defined for the user.6 params
Tool to retrieve the user's master category list. Use when you need to get all categories defined for the user.
Parameters* required
filterstringOData $filter query to filter master categories.
orderbyarrayOData $orderby query to order master categories by property values.
selectarrayOData $select query to specify properties to include.
skipintegerNumber of master categories to skip for pagination (OData $skip).
topintegerMaximum number of master categories to return (OData $top).
user_idstringThe user's unique identifier or principal name. Use 'me' for the signed-in user.default: me
OUTLOOK_GET_MESSAGERetrieves a specific email message by its ID from the specified user's Outlook mailbox. Use the 'select' parameter to include specific fields like 'internetMessageHeaders' for filtering automated emails.3 params
Retrieves a specific email message by its ID from the specified user's Outlook mailbox. Use the 'select' parameter to include specific fields like 'internetMessageHeaders' for filtering automated emails.
Parameters* required
message_idstringUnique ID of the Outlook email message to retrieve.
selectarrayList of message properties to include in the response. Each item is a property name. MUST be provided as a list. Reduces data transfer and improves performance. Common fields: id, subject, from, to...
user_idstringUser's email address, UPN, or 'me' for the currently authenticated user.default: me
OUTLOOK_GET_PROFILERetrieves the Microsoft Outlook profile for a specified user.1 params
Retrieves the Microsoft Outlook profile for a specified user.
Parameters* required
user_idstringThe user's unique identifier or principal name. Use 'me' to get the profile of the authenticated user.default: me
OUTLOOK_GET_SCHEDULERetrieves free/busy schedule information for specified email addresses within a defined time window.4 params
Retrieves free/busy schedule information for specified email addresses within a defined time window.
Parameters* required
EndTimeobjectThe end date, time, and time zone for the period for which to retrieve schedules. The period can be up to 62 days.
SchedulesarrayA list of SMTP email addresses for users, distribution lists, or resources whose schedules are to be retrieved. Maximum of 20 addresses.
StartTimeobjectThe start date, time, and time zone for the period for which to retrieve schedules.
availabilityViewIntervalstringThe duration of each time slot in the availability view, specified in minutes. Minimum: 5, Maximum: 1440. Default: 30.default: 30
OUTLOOK_GET_SUPPORTED_LANGUAGESTool to retrieve supported languages in the user's mailbox. Use when you need to display or select from available mailbox languages.1 params
Tool to retrieve supported languages in the user's mailbox. Use when you need to display or select from available mailbox languages.
Parameters* required
user_idstringThe user's unique identifier or principal name. Use 'me' for the signed-in user.default: me
OUTLOOK_GET_SUPPORTED_TIME_ZONESTool to retrieve supported time zones in the user's mailbox. Use when you need a list of time zones to display or choose from for event scheduling.1 params
Tool to retrieve supported time zones in the user's mailbox. Use when you need a list of time zones to display or choose from for event scheduling.
Parameters* required
timeZoneStandardstringSpecifies the time zone format to return. Supported values: 'Windows' or 'Iana'. Default is 'Windows' if not specified.one of
Windows · IanaOUTLOOK_LIST_CALENDARSTool to list calendars in the signed-in user's mailbox. Use when you need to retrieve calendars with optional OData queries.6 params
Tool to list calendars in the signed-in user's mailbox. Use when you need to retrieve calendars with optional OData queries.
Parameters* required
filterstringOData filter expression (OData $filter).
orderbyarrayOrder by expressions (OData $orderby).
selectarrayProperties to include (OData $select).
skipintegerNumber of calendars to skip (OData $skip).
topintegerMaximum number of calendars to return (OData $top).
user_idstringUser ID or userPrincipalName. Use 'me' for the signed-in user.default: me
OUTLOOK_LIST_CONTACTSRetrieves a user's Microsoft Outlook contacts, from the default or a specified contact folder.6 params
Retrieves a user's Microsoft Outlook contacts, from the default or a specified contact folder.
Parameters* required
contact_folder_idstringID of a specific contact folder. If omitted, contacts are retrieved from the default contact folder.
filterstringOData V4 filter expression for targeted retrieval.
orderbyarrayList of properties to sort results by. Each item is a string like 'displayName asc' or 'createdDateTime desc'. MUST be provided as a list, even for single sort criteria. 'asc' is default.
selectarrayList of specific contact properties to retrieve. Each item is a property name. MUST be provided as a list. If empty, a default set of properties is returned.
topintegerMaximum number of contacts to retrieve.default: 10
user_idstringUser Principal Name (UPN) or ID of the user. 'me' refers to the authenticated user.default: me
OUTLOOK_LIST_EMAIL_RULESList all email rules from inbox1 params
List all email rules from inbox
Parameters* required
topintegerNumber of rules to retrieve. Default is 100.
OUTLOOK_LIST_EVENT_ATTACHMENTSTool to list attachments for a specific Outlook calendar event. Use when you have an event ID and need to view its attachments.7 params
Tool to list attachments for a specific Outlook calendar event. Use when you have an event ID and need to view its attachments.
Parameters* required
event_idstringThe unique identifier of the calendar event to retrieve attachments for.
filterstringOData filter string to filter the attachments (OData $filter).
orderbyarrayOrder by clauses to sort the results (OData $orderby).
selectarrayList of attachment properties to include (OData $select).
skipintegerNumber of attachments to skip (OData $skip).
topintegerMaximum number of attachments to return (OData $top).
user_idstringThe user's primary SMTP address, UPN, or 'me' for the signed-in user.default: me
OUTLOOK_LIST_EVENTSRetrieves events from a user's Outlook calendar via Microsoft Graph API. Supports primary/secondary/shared calendars, pagination, filtering, property selection, sorting, and timezone specification. Use calendar_id to access non-primary calendars.9 params
Retrieves events from a user's Outlook calendar via Microsoft Graph API. Supports primary/secondary/shared calendars, pagination, filtering, property selection, sorting, and timezone specification. Use calendar_id to access non-primary calendars.
Parameters* required
calendar_idstringOptional ID of a specific calendar to retrieve events from.If not provided, uses the primary calendar. Get calendar IDs using LIST_CALENDARS action. Useful for accessing secondary calendars, shared...
expand_recurring_eventsbooleanWhen true, automatically expands recurring events to show actual occurrences within the filtered date range instead of series masters. When false (default), returns series masters as before.default: false
filterstringOData query string to filter events (e.g., "start/dateTime ge 'YYYY-MM-DDTHH:MM:SSZ'"); string literals use single quotes.default:
orderbyarrayList of properties to sort results by. Each item is a string like 'start/dateTime desc' or 'subject asc'. MUST be provided as a list, even for single sort criteria. Use 'asc' (default) or 'desc' fo...
selectarrayList of specific event property names to return. Each item is a property name like 'subject' or 'start'. MUST be provided as a list. If omitted, a default set of properties is returned.
skipintegerNumber of initial events to bypass, used for pagination.default: 0
timezonestringPreferred IANA or Windows timezone for event start/end times (e.g., 'America/New_York'); defaults to UTC if unspecified/invalid.default: UTC
topintegerMaximum number of events to retrieve per page for pagination.default: 10
user_idstringEmail address of the target user (or 'me' for authenticated user), identifying the calendar for event listing.default: me
OUTLOOK_LIST_MAIL_FOLDERSTool to list a user's top-level mail folders. Use when you need folders like Inbox, Drafts, Sent Items; set include_hidden_folders=True to include hidden folders.2 params
Tool to list a user's top-level mail folders. Use when you need folders like Inbox, Drafts, Sent Items; set include_hidden_folders=True to include hidden folders.
Parameters* required
include_hidden_foldersbooleanInclude hidden mail folders (isHidden=true) when set to true.default: false
user_idstringUser's id, userPrincipalName, or 'me' for the signed-in user.default: me
OUTLOOK_LIST_MESSAGESRetrieves a list of email messages from a specified mail folder in an Outlook mailbox, with options for filtering (including by conversationId to get all messages in a thread), pagination, and sorting; ensure 'user_id' and 'folder' are valid, and all date/time strings are in I...22 params
Retrieves a list of email messages from a specified mail folder in an Outlook mailbox, with options for filtering (including by conversationId to get all messages in a thread), pagination, and sorting; ensure 'user_id' and 'folder' are valid, and all date/time strings are in I...
Parameters* required
categoriesarrayFilter by categories (case-sensitive); matches if tagged with any specified category.
conversationIdstringFilter messages by conversation ID to retrieve all messages in a specific email thread.
folderstringID or well-known name of the mail folder. Well-known names: inbox, sentitems, drafts, deleteditems, outbox, junkemail. Or use a valid folder ID.default: inbox
from_addressstringFilter by the sender's exact email address. NOTE: This filter is applied client-side on the returned results, not server-side.
has_attachmentsbooleanFilter by attachment presence: 'true' for messages with attachments, 'false' for those without. NOTE: This filter is applied client-side on the returned results.
importancestringFilter by importance: 'low', 'normal', or 'high'.
is_readbooleanFilter by read status: 'true' for read, 'false' for unread. Unspecified means no filter by read status.
orderbyarrayList of properties to sort results by, with direction. Each item is a string like 'receivedDateTime desc' or 'subject asc'. Default is 'receivedDateTime desc'. Cannot be used with sentDateTime filt...
received_date_time_gestringFilter messages received on or after this ISO 8601 timestamp.
received_date_time_gtstringFilter messages received after this ISO 8601 timestamp (e.g., '2023-01-01T00:00:00Z').
received_date_time_lestringFilter messages received on or before this ISO 8601 timestamp.
received_date_time_ltstringFilter messages received before this ISO 8601 timestamp.
selectarrayList of message properties to include. Valid properties: id, subject, from, toRecipients, ccRecipients, bccRecipients, receivedDateTime, sentDateTime, hasAttachments, importance, isRead, body, body...
sent_date_time_gtstringFilter messages sent after this ISO 8601 timestamp.
sent_date_time_ltstringFilter messages sent before this ISO 8601 timestamp.
skipintegerNumber of messages to skip from the beginning of the result set, for pagination.default: 0
subjectstringFilter by exact match of the subject line. Special characters like apostrophes, brackets will be automatically escaped. For complex subject searches, consider using 'Search Messages' instead.
subject_containsstringFilter messages where the subject contains the specified case-insensitive substring. NOTE: This filter is applied client-side on the returned results. For better performance, use 'Search Messages'...
subject_endswithstringFilter messages where the subject ends with the specified case-insensitive string. NOTE: This filter is applied client-side on the returned results. For better performance, use 'Search Messages' in...
subject_startswithstringFilter messages where the subject starts with the specified case-insensitive string.
+2 more parameters. See the server's own documentation for the full schema.
OUTLOOK_LIST_OUTLOOK_ATTACHMENTSLists metadata (like name, size, and type, but not `contentBytes`) for all attachments of a specified Outlook email message.2 params
Lists metadata (like name, size, and type, but not `contentBytes`) for all attachments of a specified Outlook email message.
Parameters* required
message_idstringThe unique identifier of the email message from which to retrieve attachments. This ID is specific to the Outlook message.
user_idstringThe unique identifier of the user. Use the user's UPN (e.g., 'AdeleV@contoso.onmicrosoft.com') or 'me' for the currently authenticated user. This specifies the mailbox to query.default: me
OUTLOOK_LIST_REMINDERSTool to retrieve reminders for events occurring within a specified time range. Use when you need to see upcoming reminders between two datetimes.3 params
Tool to retrieve reminders for events occurring within a specified time range. Use when you need to see upcoming reminders between two datetimes.
Parameters* required
endDateTimestringThe end date and time in ISO 8601 format defining the window for reminders. Example: '2023-10-26T20:00:00.0000000'.
startDateTimestringThe start date and time in ISO 8601 format defining the window for reminders. Example: '2023-10-26T19:00:00.0000000'.
userIdstringUser Principal Name or ID. Use 'me' to indicate the signed-in user.default: me
OUTLOOK_LIST_USERSTool to list users in Microsoft Entra ID. Use when you need to retrieve a paginated list of users, optionally filtering or selecting specific properties.4 params
Tool to list users in Microsoft Entra ID. Use when you need to retrieve a paginated list of users, optionally filtering or selecting specific properties.
Parameters* required
filterstringOData filter expression to restrict returned users (OData $filter).
selectarrayList of user properties to include in the response (OData $select).
skipintegerNumber of users to skip (OData $skip) for pagination.
topintegerMaximum number of users to return (OData $top). Default page size is 100, maximum is 999.
OUTLOOK_MOVE_MESSAGEMove a message to another folder within the specified user's mailbox. This creates a new copy of the message in the destination folder and removes the original message.3 params
Move a message to another folder within the specified user's mailbox. This creates a new copy of the message in the destination folder and removes the original message.
Parameters* required
destination_idstringThe destination folder ID, or a well-known folder name (e.g., 'inbox', 'deleteditems', 'drafts', 'sentitems').
message_idstringUnique ID of the Outlook email message to move.
user_idstringUser's email address, UPN, or 'me' for the currently authenticated user.default: me
OUTLOOK_QUERY_EMAILSPrimary tool for querying Outlook emails with custom OData filters. Build precise server-side filters for dates, read status, importance, subjects, attachments, and conversations. Best for structured queries on message metadata. Returns up to 100 messages per request with pagi...7 params
Primary tool for querying Outlook emails with custom OData filters. Build precise server-side filters for dates, read status, importance, subjects, attachments, and conversations. Best for structured queries on message metadata. Returns up to 100 messages per request with pagi...
Parameters* required
filterstringOData $filter query string to filter email messages. Syntax: 'field operator value' combined with 'and', 'or', 'not'.
**Operators:** eq, ne, lt, le, gt, ge, startswith(), endswith(), conta...
folderstringID or well-known name of the mail folder. Well-known names: 'inbox', 'sentitems', 'drafts', 'deleteditems', 'outbox', 'junkemail' (case-insensitive). Or use a valid folder ID.default: inbox
orderbystringComma-separated sort keys with direction. Format: 'field asc' or 'field desc'. Common fields: receivedDateTime, sentDateTime, subject, importance, from. NOTE: Ordering may be automatically disabled...default: receivedDateTime desc
selectarrayList of message properties to include in the response. Reduces data transfer and improves performance. Common fields: id, subject, from, toRecipients, ccRecipients, receivedDateTime, sentDateTime,...
skipintegerNumber of messages to skip for pagination. NOTE: For large result sets, prefer using '@odata.nextLink' from responses instead of manual skip.default: 0
topintegerMaximum number of messages to return per request (1-1000). Default is 100. IMPORTANT: For large mailboxes, always check response['@odata.nextLink'] to fetch remaining messages. Pagination example:...default: 100
user_idstringTarget user's email or 'me' for authenticated user. IMPORTANT: 'me' uses the currently connected account. For cross-mailbox access, ensure you have Mail.Read or Mail.ReadWrite permissions on the ta...default: me
OUTLOOK_REPLY_EMAILSends a plain text reply to an Outlook email message, identified by `message_id`, allowing optional CC and BCC recipients.5 params
Sends a plain text reply to an Outlook email message, identified by `message_id`, allowing optional CC and BCC recipients.
Parameters* required
bcc_emailsarrayList of email addresses for BCC recipients.
cc_emailsarrayList of email addresses for CC recipients.
commentstringThe plain text body of the reply email.
message_idstringThe unique ID of the message to reply to. This ID can be obtained from the `OUTLOOK_LIST_MESSAGES` action.
user_idstringThe user's email address or 'me' to indicate the authenticated user. This specifies the mailbox from which the reply will be sent.default: me
OUTLOOK_SEARCH_MESSAGESSearch Outlook messages using powerful KQL syntax. Supports sender (from:), recipient (to:, cc:), subject, date filters (received:, sent:), attachments, and boolean logic. Only works with Microsoft 365/Enterprise accounts (no @hotmail.com/@outlook.com). Examples: 'from:user@ex...7 params
Search Outlook messages using powerful KQL syntax. Supports sender (from:), recipient (to:, cc:), subject, date filters (received:, sent:), attachments, and boolean logic. Only works with Microsoft 365/Enterprise accounts (no @hotmail.com/@outlook.com). Examples: 'from:user@ex...
Parameters* required
enable_top_resultsbooleanIf `true`, sorts results by relevance; otherwise, sorts by date in descending order (newest first).default: false
fromEmailstringFilter messages by sender email address or domain. Supports exact email ('user@example.com') or domain matching ('example.com'). Legacy parameter - prefer using 'from:email@example.com' in the quer...
from_indexintegerThe 0-based starting index for pagination. To paginate: check response['value'][0]['hitsContainers'][0]['moreResultsAvailable']. If true, call again with from_index += size (e.g., 0 → 25 → 50). Mes...default: 0
hasAttachmentsbooleanFilters messages based on the presence of attachments. Legacy parameter - prefer using 'hasattachment:yes' or 'hasattachment:no' in the query parameter.
querystringKQL (Keyword Query Language) search query string. Supports advanced syntax for precise searches.
**Basic Syntax:**
- Simple keywords: 'budget report'
- Exact phrases: '"quarterly review"'
- Boolea...default:
sizeintegerThe maximum number of search results to return per page. Use with from_index for pagination.default: 25
subjectstringText to search for within the message subject line. Legacy parameter - prefer using 'subject:text' in the query parameter for more control. Example: Instead of subject='invoice', use query='subject...
OUTLOOK_SEND_DRAFTTool to send an existing draft message. Use after creating a draft when you want to deliver it to recipients immediately. Example: Send a draft message with ID 'AAMkAG…'.2 params
Tool to send an existing draft message. Use after creating a draft when you want to deliver it to recipients immediately. Example: Send a draft message with ID 'AAMkAG…'.
Parameters* required
message_idstringThe unique identifier of the draft message to send.
user_idstringThe user's email address or 'me' to represent the authenticated user.default: me
OUTLOOK_SEND_EMAILSends an email with subject, body, recipients, and an optional attachment via Microsoft Graph API. Supports comma-separated email addresses in the to_email field for multiple recipients. Attachments require a non-empty file with valid name and mimetype.11 params
Sends an email with subject, body, recipients, and an optional attachment via Microsoft Graph API. Supports comma-separated email addresses in the to_email field for multiple recipients. Attachments require a non-empty file with valid name and mimetype.
Parameters* required
attachmentstringOptional file to attach. If provided, its name, mimetype, and content must be valid and non-empty.
bcc_emailsarrayList of email addresses for BCC recipients. Each email should be a separate string in the array. Do NOT pass comma-separated values as a single string.
bodystringThe content of the email body, plain text or HTML based on `is_html`.
cc_emailsarrayList of email addresses for CC recipients. Each email should be a separate string in the array. Do NOT pass comma-separated values as a single string.
fromstringOptional From address to set on the message (send as/on behalf). Provide a single email address. Requires appropriate mailbox permissions.
is_htmlbooleanSpecifies if the email body is HTML; `True` for HTML, `False` for plain text.default: false
save_to_sent_itemsbooleanIndicates if the email should be saved in 'Sent Items'.default: true
subjectstringThe subject line of the email.
to_emailstringThe primary recipient's email address(es). You can provide a single email or multiple emails separated by commas. For CC/BCC recipients, use the respective fields.
to_namestringThe display name of the primary recipient.
user_idstringThe user's email address or the alias 'me' to represent the authenticated user.default: me
OUTLOOK_UPDATE_CALENDAR_EVENTUpdates specified fields of an existing Outlook calendar event. Implementation note: To avoid unintentionally clearing properties, the action first fetches the existing event, merges only the provided fields, and then PATCHes the merged updates. Unspecified fields remain uncha...11 params
Updates specified fields of an existing Outlook calendar event. Implementation note: To avoid unintentionally clearing properties, the action first fetches the existing event, merges only the provided fields, and then PATCHes the merged updates. Unspecified fields remain uncha...
Parameters* required
attendeesarrayAttendee list for the event. If provided, replaces the existing attendees. If omitted, attendees remain unchanged.
bodyobjectEvent body with content type ('Text' or 'HTML') and the content. If omitted, the existing body remains unchanged.
categoriesarrayCategory names to associate with the event. If provided (even empty), replaces the existing categories. If omitted, categories remain unchanged.
end_datetimestringNew end date and time for the event. Provide together with a time zone, or the current event's time zone will be used. Must be after start_datetime if both are provided. If omitted, the end time re...
event_idstringThe unique identifier of the calendar event to be updated. This ID can be obtained from the OUTLOOK_LIST_EVENTS action.
locationobjectEvent location as a dictionary. If provided, replaces the existing primary location. Omit to leave unchanged.
show_asstringAvailability status for the event. Valid values: 'free', 'tentative', 'busy', 'oof'. If omitted, the existing status remains unchanged.
start_datetimestringNew start date and time for the event. Provide together with a time zone, or the current event's time zone will be used. If omitted, the start time remains unchanged.
subjectstringNew subject for the event. If provided as an empty string, the subject will be cleared. If omitted, the existing subject remains unchanged.
time_zonestringTime zone for the provided start_datetime and/or end_datetime (IANA or Windows time zone names). If omitted, the existing event's time zone is used.
user_idstringThe identifier of the user whose calendar event is to be updated. Accepts the user's principal name, ID, or 'me' for the currently authenticated user.default: me
OUTLOOK_UPDATE_CONTACTUpdates an existing Outlook contact, identified by `contact_id` for the specified `user_id`, requiring at least one other field to be modified.16 params
Updates an existing Outlook contact, identified by `contact_id` for the specified `user_id`, requiring at least one other field to be modified.
Parameters* required
birthdaystringContact's birthday (YYYY-MM-DD format).default:
businessPhonesarrayContact's business phone numbers.
categoriesarrayCategories for organizing the contact.
companyNamestringContact's company name.default:
contact_idstringUnique identifier of the contact to update.
departmentstringContact's department.default:
displayNamestringContact's full display name.default:
emailAddressesarrayContact's email addresses.
givenNamestringContact's given (first) name.default:
homePhonesarrayContact's home phone numbers.
jobTitlestringContact's job title.default:
mobilePhonestringContact's mobile phone number.default:
notesstringPersonal notes about the contact (maps to 'personalNotes' in Microsoft Graph API).default:
officeLocationstringContact's office location.default:
surnamestringContact's surname (last name).default:
user_idstringUser's identifier; 'me' for the signed-in user, or user's principal name/ID.default: me
OUTLOOK_UPDATE_EMAILUpdates specified properties of an existing email message; `message_id` must identify a valid message within the specified `user_id`'s mailbox.9 params
Updates specified properties of an existing email message; `message_id` must identify a valid message within the specified `user_id`'s mailbox.
Parameters* required
bcc_recipientsarrayList of BCC recipients; replaces all existing BCCs. Omitting this field removes all current BCC recipients.
bodyobjectNew body content (Text or HTML). If omitted, the existing message body remains unchanged.
cc_recipientsarrayList of CC recipients; replaces all existing CCs. Omitting this field removes all current CC recipients.
importancestringNew importance level ('low', 'normal', 'high'). If omitted, importance is set to 'normal'.default: normal
is_readbooleanMark message as read (True) or unread (False). If omitted, read status remains unchanged.
message_idstringThe unique identifier of the email message to be updated. This ID is typically obtained from listing messages or creating/sending a message.
subjectstringNew subject line. If omitted, the existing subject remains unchanged. Provide empty string to clear the subject.
to_recipientsarrayList of TO recipients; replaces all existing TOs. Omitting this field removes all current TO recipients.
user_idstringThe UPN (User Principal Name) of the user whose mailbox contains the message, or 'me' for the currently authenticated user. This determines whose message is updated.default: me
OUTLOOK_UPDATE_EMAIL_RULEUpdate an existing email rule6 params
Update an existing email rule
Parameters* required
actionsobjectUpdated actions to take when the rule conditions are met.
conditionsobjectUpdated conditions that must be met for the rule to apply.
displayNamestringUpdated display name for the email rule.
isEnabledbooleanWhether the rule should be enabled or disabled.
ruleIdstringID of the email rule to update.
sequenceintegerUpdated order in which the rule is executed (lower numbers execute first).
OUTLOOK_UPDATE_MAILBOX_SETTINGSTool to update mailbox settings for the signed-in user. Use when you need to configure automatic replies, default time zone, language, or working hours. Example: schedule automatic replies for vacation.4 params
Tool to update mailbox settings for the signed-in user. Use when you need to configure automatic replies, default time zone, language, or working hours. Example: schedule automatic replies for vacation.
Parameters* required
automaticRepliesSettingobjectConfiguration for automatic replies.
languageobjectLocale preferences for date/time formatting.
timeZonestringDefault mailbox time zone (e.g., 'Pacific Standard Time').
workingHoursobjectWorking hours configuration for the user.
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Configuration
MS_CLIENT_ID*Microsoft OAuth client ID (required for OAuth authentication modes)
MS_TENANT_ID*Microsoft tenant ID (required for OAuth authentication)
MS_CLIENT_SECRETsecretMicrosoft OAuth client secret (optional for public clients)
AUTH_MODEAuthentication mode
HEADLESSdefault: falseDisable browser auto-open, return auth URL instead (true/false)
REDIRECT_URIOAuth redirect URI (optional, default: ephemeral loopback)
RESOURCE_STORE_URIResource store URI for CSV export files (file://)
PORTHTTP server port (overrides --port)
BASE_URLBase URL for HTTP transport (used for OAuth/DCR endpoints and file links)
LOG_LEVELLogging level
DCR_MODEdefault: self-hostedDynamic Client Registration mode
DCR_VERIFY_URLExternal verification endpoint URL (required for external DCR mode)
DCR_STORE_URIdefault: file://~/.mcp-z/mcp-outlook/dcr.jsonDCR client storage URI (for self-hosted DCR mode)
Registryactive
Package@mcp-z/mcp-outlook
TransportSTDIO, HTTP
AuthRequired
UpdatedJan 10, 2026
