Your AI team, working in Outlook

Outlook is Microsoft's email and calendaring platform integrating contacts and scheduling, enabling users to manage communications and events in a unified workspace

Start your company

What your team can do in Outlook

327 tools to work with, connected with your account.

Accept calendar event invite

Accepts or tentatively accepts a calendar meeting invite on behalf of a user. Use this action when a user has received a meeting invitation and wants to indicate their attendance status (either confirmed or tentative). The organizer will receive a notification of the acceptance unless send_response is set to false.

Add event attachment

Adds an attachment to a specific Outlook calendar event. Use when you need to attach a file or nested item to an existing event.

Add mail attachment

Adds a small file attachment to an Outlook email message identified by its message ID, using an uploaded file or base64-encoded content.

Batch move messages

Batch-move up to 20 Outlook messages to a destination folder in a single Microsoft Graph $batch call. Use when moving multiple messages to avoid per-message move API calls.

Batch update messages

Batch-update up to 20 Outlook messages per call using Microsoft Graph JSON batching. Use when marking multiple messages read/unread or updating other properties to avoid per-message PATCH calls.

Cancel user calendar event

Cancel a calendar event for a specified user and send cancellation notifications to attendees. The calendar owner must be the meeting organizer; an optional comment can be sent with the cancellation.

Cancel user calendar group event

Tool to cancel an event in a user's calendar within a calendar group and send cancellation notifications to all attendees. Use when canceling a meeting or event for a specific user in a calendar that belongs to a calendar group.

Cancel user's calendar event

Cancels an organizer's event in a specified user's calendar and sends cancellation notifications to attendees. An optional comment can accompany the cancellation.

Copy child mail folder

Copies a child mail folder and its contents to a destination folder in the user's mailbox.

Copy message from child folder

Tool to copy an email message from a child folder (nested folder) to another folder within the user's mailbox. Use when duplicating messages from nested folder structures.

Copy message to folder

Tool to copy an email message to another folder within the user's mailbox. Use when duplicating messages to multiple folders for organization.

Copy user message from folder

Tool to copy a message from a specific user's mail folder to another folder. Use when you need to duplicate a message from a known source folder to a destination folder for a specific user.

Copy user's mail folder

Tool to copy a user's mail folder and its contents to another folder. Use when you need to duplicate a folder structure for a specific user's mailbox.

Count messagesReads only

Count all messages, or messages matching an OData filter or KQL search, in an Outlook mailbox.

Create a draft reply

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.

Create attachment upload session

Tool to create an upload session for large (>3 MB) message attachments. Use when you need to upload attachments in chunks.

Create attachment upload session in child folder

Tool to create an upload session for large (>3 MB) message attachments in child mail folders. Use when you need to upload attachments to messages in nested folder structures.

Create calendar

Creates a new calendar in the signed-in user's or a specified user's mailbox, for organizing events into a separate calendar.

Create Calendar Event

Creates a new Outlook calendar event, ensuring `start_datetime` is chronologically before `end_datetime`.

Create calendar event attachment

Creates a file or item attachment on an event in a specific calendar using the authenticated user's mailbox. This action supports delegated access, not app-only authentication.

Create calendar event attachment upload session

Tool to create an upload session for large calendar event attachments in a specific calendar. Use when attaching files larger than 3 MB to Outlook calendar events in a specific calendar.

Create calendar event for user

Create a new calendar event in a user's default calendar.

Create calendar group

Tool to create a new calendar group for a user. Use when needing to organize calendars into groups.

Create calendar group event attachment upload session

Tool to create an upload session for large calendar group event attachments. Use when attaching files larger than 3 MB to events in calendar groups.

Create calendar in user's calendar group

Tool to create a new calendar in a calendar group for a specific user. Use when organizing events into a separate calendar within a specific calendar group for a user.

Create Calendar Permission

Tool to create a calendar permission for a specific calendar in a calendar group. Use when granting access to a calendar for another user.

Create calendar permission via event

Tool to create a calendar permission via an event's calendar. Use when granting calendar access through an event by specifying the event ID and user email address.

Create contact

Creates a new contact in a Microsoft Outlook user's contacts folder.

Create contact extension

Tool to create a new open extension on a contact within a child folder. Use when you need to store custom data with a contact.

Create contact folder

Tool to create a new contact folder in the user's mailbox. Use when needing to organize contacts into custom folders.

Create contact in child folder

Tool to create a new contact in a child folder within a contact folder. Use when you need to add a contact to a specific nested folder structure.

Create email draft

Creates a new Outlook email draft with subject, body, recipients, and an optional attachment. This action creates a standalone draft for new conversations. To create a draft reply to an existing conversation/message, use the OUTLOOK_CREATE_DRAFT_REPLY action instead.

Create Email Rule

Create email rule filter with conditions and actions

Create event attachment upload session

Tool to create an upload session for large calendar event attachments. Use when attaching files larger than 3 MB to Outlook calendar events.

Create event extension

Tool to create a new open extension on a calendar event within a specific calendar group and calendar. Use when you need to store custom data with an event.

Create event in specific calendar

Tool to create a new event in a specific calendar for a user. Use when you need to create events in a specific calendar (e.g., shared or secondary calendars).

Create forward draft

Tool to create a draft forward of an existing message. Use when you need to prepare a forward that can be edited before sending. The draft can be updated with recipients and additional content before being sent.

Create mail folder

Tool to create a new mail folder. Use when you need to organize email into a new folder.

Create mail folder message attachment

Tool to add an attachment to a message in a specific mail folder. Use when you need to attach a file to a message located in a particular mail folder.

Create mail folder message attachment upload session

Tool to create an upload session for large (>3 MB) message attachments in a specific mail folder. Use when you need to upload attachments in chunks to a message located in a mail folder.

Create me event attachment upload session

Tool to create an upload session for large event attachments. Use when attaching files larger than 3 MB to the authenticated user's Outlook events.

Create message attachment

Tool to create an attachment for a message. Use when you need to attach a file or item to an existing message. Supports file attachments, item attachments, and reference attachments.

Create message in mail folder

Tool to create a new message in a specific mail folder. Use when you need to create a draft message in a particular folder (e.g., drafts, custom folders).

Create message in user's child folder

Tool to create a new draft message in a child folder within a user's mail folder. Use when creating messages in nested folder structures for a specific user's mailbox.

Create Microsoft 365 group event

Create an event in a Microsoft 365 group's default calendar using delegated access. Supplying attendees sends meeting invitations to them.

Create reply draft

Deprecated. Creates a reply draft for a specified message in the authenticated user's or another user's mailbox.

Create reply draft for user mail folder message

Tool to create a reply draft for a message in a user's mail folder. Use when you need to prepare a reply without sending it immediately. The draft is created in the Drafts folder and includes the RE: prefix in the subject line.

Create reply-all draft for child folder message

Tool to create a draft reply-all to a message in a child folder. Use when you need to create a draft reply to the sender and all recipients of a message located in a subfolder within a mail folder.

Create reply-all draft for mail folder message

Creates a reply-all draft for a message in a specified mail folder, optionally including a comment. This tool is deprecated.

Create reply-all draft for user message

Tool to create a draft reply-all to a user's message. Use when you need to create a draft reply to the sender and all recipients of an email message in a user's mailbox.

Create reply-all draft in folder

Tool to create a reply-all draft for a message in a mail folder. Use when you need to create a draft reply to all recipients of an email.

Create To Do task

Tool to create a new task in Microsoft To Do within a specified task list. Use when adding tasks with title, due dates, reminders, importance levels, descriptions, categories, and linked resources.

Create user calendar event attachment

Tool to create a new attachment for a user's calendar event. Use when you need to attach a file or item to an existing event in a specific user's calendar.

Create user calendar event attachment

Tool to create a new attachment for an event in a specific user's calendar. Use when you need to attach a file or item to an event within a particular user's calendar.

Create user calendar event extension

Tool to create a new open extension on a calendar event for a specific user. Use when you need to store custom data with an event.

Create user calendar group event

Tool to create a new calendar event in a specific user's calendar within a calendar group. Use when creating events for a particular user in a calendar that belongs to a calendar group.

Create user calendar group event attachment

Tool to create a new attachment for an event in a calendar within a calendar group for a specific user. Use when you need to attach a file or item to an event in a user's calendar group.

Create user calendar permission

Tool to create a new calendar permission for a specific user's calendar. Use when you need to share another user's calendar with someone or grant access with specific permission levels.

Create user contact extension

Tool to create a new open extension on a contact within a user's contact folder. Use when you need to store custom data with a contact.

Create user contact extension

Tool to create a new open extension on a specific user's contact. Use when you need to store custom data with a contact for a specific user.

Create user contact folder child folder

Tool to create a child contact folder within a parent contact folder for a specific user. Use when you need to organize contacts into nested folder hierarchies for a given user.

Create user contact in folder

Tool to create a new contact in a specific user's contact folder. Use when you need to add a contact to a particular folder for a specified user.

Create user event attachment upload session

Creates an upload session for a file attachment on a specified user's calendar event and returns the upload URL and session details. This tool is deprecated.

Create user Focused Inbox override

Tool to create a Focused Inbox override for a sender identified by SMTP address for a specific user. Use when you need to configure messages from a specific sender to always be classified as focused or other for a particular user.

Create user mail folder message extension

Tool to create a new open extension on a message in a user's mail folder. Use when you need to store custom data with a specific message in a user's mailbox.

Create user mail folder message forward draft

Tool to create a forward draft of an Outlook message for a specific user. Use when you need to prepare a forward email that can be edited before sending. The draft is created in the Drafts folder with the FW: prefix in the subject line.

Create User Mail Folder Message Rule

Tool to create a message rule in a user's mail folder. Use when automating message processing with filters and actions.

Create user mail folders child folders

Tool to create a new child folder under a specified mail folder for a user. Use when organizing email into nested folder hierarchies within a specific user's mailbox.

Create user master category

Tool to create a new category in a user's master category list. Use when you need to add a category to organize email and calendar items for a specific user.

Create user message

Tool to create a new draft message in a user's mailbox. Use when creating draft messages for a specific user or the authenticated user.

Create user message attachment

Tool to create an attachment on a message in a user's mail folder. Use when you need to attach a file or item to an existing message in a specific user's mailbox.

Create user message extension

Tool to create a new open extension on a message in a child mail folder for any user. Use when you need to store custom data with a message in a nested folder structure.

Decline calendar event

Declines a calendar event invitation, optionally including a comment or proposed new time and controlling whether a response is sent. Returns a success message when the request is accepted.

Delete calendar

Tool to delete a calendar other than the default calendar from a user's mailbox. Use when removing calendars that are no longer needed.

Delete calendar event

Tool to delete a calendar event from a user's Outlook calendar. Use when removing events that are no longer needed or were created in error.

Delete calendar group

Tool to delete a calendar group other than the default calendar group. Use when removing unused calendar groups from the mailbox.

Delete calendar group event attachment

Tool to delete an attachment from an event in a calendar within a calendar group. Use when you need to remove a file or item attachment from an event in a specific calendar group.

Delete Child Folder Message

Tool to delete a message from a child mail folder in Outlook. Use when removing messages from nested folder structures or cleaning up messages in subfolders.

Delete Contact

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`.

Delete contact extension

Tool to delete a navigation property extension from a contact within a child folder. Use when removing custom extension data from a contact.

Delete contact extension

Tool to delete an open extension from a contact. Use when removing custom data extensions that are no longer needed.

Delete contact folder

Tool to delete a contact folder from the user's mailbox. Use when you need to remove an existing contact folder.

Delete Contact from Folder

Tool to permanently delete a contact from a specific contact folder. Use when removing contacts from organized folders in Outlook.

Delete Contact from User's Child Folder

Tool to delete a contact from a child folder in a user's contact folder. Use when you need to remove a contact from a specific child folder within a contact folder.

Delete Email Rule

Delete an email rule permanently; deletion is irreversible. Confirm rule details with the user before executing. Removing a rule may alter the firing order and stop-processing behavior of remaining rules.

Delete event attachment

Tool to delete an attachment from an Outlook calendar event. Use when you need to remove a file or item attachment from an existing event.

Delete event extension

Tool to delete an open extension from a calendar event in a calendar group. Use when removing custom extension data that is no longer needed.

Delete event from specific calendar

Tool to delete an event from a specific calendar in Outlook. Use when removing events from secondary or shared calendars by providing both calendar ID and event ID.

Delete inference classification override

Tool to delete an inference classification override for a specific sender. Use when removing custom Focused Inbox rules that were previously set.

Delete mail folder

Delete a mail folder from a user's mailbox. The tool rejects well-known system folder names as folder identifiers.

Delete mail folder child folder

Tool to delete a child mail folder from a parent mail folder. Use when removing nested mail folders from a user's mailbox.

Delete Mail Folder Message

Tool to delete a message from a specific mail folder in Outlook. Use when removing messages from a particular folder or cleaning up folder contents.

Delete mail folder message rule

Tool to delete a message rule from a specific mail folder. Use when you need to remove an email automation rule from a folder.

Delete master category

Tool to delete a category from the user's master category list. Use when removing unused or obsolete categories from the mailbox.

Delete Message

Tool to permanently delete an Outlook email message by its message_id. Use when removing unwanted messages, cleaning up drafts, or performing mailbox maintenance.

Delete Message Attachment

Tool to delete an attachment from a message. Use when removing file or item attachments from messages in Outlook.

Delete Message Attachment

Delete an attachment from a message in a mail folder or its child folder.

Delete message extension

Tool to delete a navigation property extension from a message within a mail folder. Use when removing custom extension data from a message.

Delete message extension

Tool to delete an open extension from an Outlook message. Use when removing custom extension data that is no longer needed from a message.

Delete To Do task

Tool to permanently delete a task from a Microsoft To Do task list. Use when removing a task that is no longer needed. This action cannot be undone.

Delete user calendar event attachment

Tool to delete an attachment from an event in a specific user's calendar. Use when you need to remove a file or item attachment from an event in a calendar.

Delete user calendar group calendar

Tool to delete a calendar from a specific user's calendar group in Microsoft Outlook. Use when removing a calendar that belongs to a user's calendar group.

Delete user calendar group calendar event

Tool to delete a calendar event from a specific user's calendar within a calendar group. Use when removing events from calendars organized under calendar groups for a specific user.

Delete User Calendar Group Calendar Permission

Tool to delete a calendar permission from a user's calendar within a calendar group. Use when revoking calendar sharing access for specific users.

Delete User Calendar Permission

Delete a calendar permission from a user's primary calendar to revoke calendar sharing access.

Delete User Calendars Calendar Permission

Tool to delete a calendar permission from a specific user's calendar. Use when revoking access to a shared calendar.

Delete User Child Folder Message Permanently

Tool to permanently delete a message from a user's child mail folder in Outlook. Unlike standard DELETE, this action makes the message unrecoverable by moving it to the Purges folder in the dumpster. Use when you need to ensure a message in a nested folder cannot be restored from deleted items.

Delete user contact extension

Deletes an extension from a contact in a user's child contact folder. This tool is deprecated.

Delete user contact folder child folder

Tool to delete a child contact folder from a parent contact folder for a specific user. Use when removing nested contact folders from a user's mailbox.

Delete user contact folder contact extension

Tool to delete an extension from a contact in a user's contact folder. Use when removing custom extension data from a contact.

Delete user event attachment

Tool to delete an attachment from a user's Outlook event. Use when you need to remove a file or item attachment from an existing event.

Delete user event extension

Tool to delete an open extension from a user's calendar event. Use when removing custom extension data that is no longer needed.

Delete user message attachment

Deprecated. Deletes an attachment from a message in the authenticated user's mailbox or a specified user's mailbox.

Delete user message extension

Delete user message extension

Dismiss event reminder

Dismiss a reminder for a specific event in the signed-in user's or specified user's default calendar.

Dismiss user calendar event reminder

Tool to dismiss a reminder for a specific event in a user's calendar. Use when you need to turn off or remove a reminder alert for an event in a specific user's calendar.

Dismiss user calendar group event reminder

Tool to dismiss a reminder for an event in a user's calendar within a calendar group. Use when you need to turn off a reminder for an event in a specific user's calendar group.

Dismiss user event reminder

Tool to dismiss a reminder for a specific user's calendar event. Use when you need to turn off or remove a reminder alert for an event in a user's calendar.

Download group post attachmentReads only

Download raw file content or item-attachment MIME content from a Microsoft 365 group conversation post. Reference attachments are not supported.

Download Outlook attachmentReads only

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. High-volume parallel calls may trigger HTTP 429 responses; honor the Retry-After header and use exponential backoff.

Download profile photoReads only

Download the signed-in user's profile-photo bytes at a fixed size.

Find Meeting TimesReads only

Suggest meeting times based on organizer and attendee availability, time constraints, and duration requirements. Requires delegated access with a work or school account.

Forward message

Tool to forward a message. Use when you need to send an existing email to new recipients.

Forward user calendar event

Tool to forward a calendar event from a specific user's calendar to new recipients. Use when you need to share an event from a particular calendar with additional people.

Get allowed calendar sharing roles for user calendarReads only

Tool to retrieve allowed calendar sharing roles for a specific user on a given calendar. Use when you need to determine what permission levels can be granted to a user for sharing a specific calendar.

Get attachment from nested folder messageReads only

Tool to retrieve a specific attachment from a message located in a nested mail folder structure. Use when you need to get attachment details from messages in deeply nested folders.

Get calendar eventReads only

Retrieves the full details of a specific calendar event by its ID from a user's Outlook calendar, provided the event exists.

Get calendar event attachmentReads only

Tool to retrieve a specific attachment from an event within a calendar. Use when you need to access attachment content from a calendar event.

Get calendar from calendar groupReads only

Tool to retrieve a specific calendar from a calendar group in Microsoft Outlook. Use when you need to get details of a calendar that belongs to a specific calendar group.

Get calendar from eventReads only

Tool to retrieve the parent calendar that contains a specific event. Use when you need to get calendar details for a specific event in a calendar.

Get calendar groupReads only

Retrieve the properties of a specific Outlook calendar group by its ID, with optional property selection.

Get calendar group event attachmentReads only

Deprecated: Use OUTLOOK_GET_USER_CALENDAR_GROUP_EVENT_ATTACHMENT instead, which supports both /me and /users/{user_id} endpoints.

Get Calendar ScheduleReads only

Tool to get free/busy schedule information for users, distribution lists, or resources. Use when you need to check availability for specific people or resources during a time period.

Get Calendar ViewReads only

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.

Get Calendar View from User Calendar GroupReads only

Tool to get calendar view from a specific calendar within a calendar group for a user. Use when retrieving events from a calendar that belongs to a calendar group.

Get calendar view from user's calendarReads only

Tool to get calendar view from a specific user's calendar. Use when you need to retrieve events that occur or overlap with a specified time window from a user's specific calendar by calendar ID.

Get child folder messageReads only

Tool to retrieve a specific email message from a child mail folder. Use when you need to access a message in a nested folder hierarchy.

Get child folder message MIME contentReads only

Tool to get the MIME content of a message from a child mail folder. Use when you need to download the raw MIME format of an email message for analysis or archival.

Get child mail folderReads only

Tool to retrieve a specific child mail folder from a parent mail folder. Use when you need details about a specific subfolder within a folder hierarchy.

Get contactReads only

Retrieves a specific Outlook contact by its `contact_id` from the contacts of a specified `user_id` (defaults to 'me' for the authenticated user).

Get contact extensionReads only

Retrieves an open extension from a contact in a specified contact folder in Microsoft Graph. The response contains extension identification metadata, not the extension's custom data fields.

Get contact folderReads only

Tool to retrieve a specific contact folder by ID. Use when you need details about a particular contact folder in the user's mailbox.

Get contact from child folderReads only

Tool to retrieve a specific contact from a nested child folder within a contact folder. Use when you need contact details from a child folder.

Get contact from folderReads only

Tool to retrieve a specific contact from a contact folder by its ID. Use when you need to access contact details from a specific folder rather than the default contacts location.

Get contact photoReads only

Tool to get the binary media content of a contact's profile photo. Use when you need to download or retrieve a contact's picture.

Get contact photo metadataReads only

Retrieve dimensions and optional media metadata for a contact's photo.

Get drafts mail folderReads only

Tool to get the drafts mail folder. Use when you need to retrieve details about the drafts folder such as item counts and folder ID.

Get drive itemReads only

Retrieve metadata for one file or folder from a Microsoft Graph drive.

Get email messageReads only

Retrieve a message by immutable ID from the specified Outlook mailbox. Use `select` to include fields such as `internetMessageHeaders`. A 404 can indicate a deleted message, a different mailbox, or a stale legacy mutable ID.

Get event attachmentReads only

Retrieve a specific attachment from an Outlook calendar event by attachment ID. The response includes attachment details and, for file attachments, may include base64-encoded content.

Get event calendarReads only

Tool to retrieve the calendar that contains a specific event. Use when you need to get calendar details for an event.

Get event calendar from calendar groupReads only

Tool to retrieve the calendar that contains a specific event within a calendar group. Use when you need to get calendar details for an event in a calendar group.

Get event extensionReads only

Retrieve an open extension's identifiers and metadata from an event in a specified calendar group and calendar. The response does not include arbitrary custom extension data.

Get event extensionReads only

Tool to retrieve a specific open type extension from a user's calendar event by its extension ID or name. Use when you need to access custom data stored in calendar event extensions.

Get event from calendarReads only

Tool to retrieve a specific event from a specified calendar. Use when you need to get details of an event that belongs to a specific calendar in the user's mailbox.

Get group post attachmentReads only

Retrieve one attachment from a Microsoft 365 group conversation post using delegated access.

Get inference classificationReads only

Tool to get inference classification settings for the authenticated user. Use when you need to retrieve the Focused Inbox configuration and sender-specific overrides that determine message classification.

Get mail deltaReads only

Retrieve incremental message changes in one mailbox folder, defaulting to Inbox. Page through initial or subsequent results using the returned next link, then store the delta link for the next synchronization.

Get mail folderReads only

Retrieve one Outlook mail folder by opaque ID or well-known name, optionally selecting only needed metadata such as display name and item counts. Supports the signed-in mailbox or an explicit user mailbox. Use OUTLOOK_LIST_MAIL_FOLDERS to discover top-level IDs and OUTLOOK_LIST_CHILD_MAIL_FOLDERS for nested IDs.

Get mail folder messageReads only

Tool to retrieve a specific message from a mail folder by its ID. Use when you need to fetch full message details including subject, body, sender, recipients, timestamps, and other metadata from a specific mail folder.

Get mail tipsReads only

Tool to retrieve mail tips such as automatic replies and mailbox full status. Use when you need to check recipient status before sending mail.

Get mailbox settingsReads only

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.

Get master categoriesReads only

Tool to retrieve the user's master category list. Use when you need to get all categories defined for the user.

Get master categoryReads only

Tool to retrieve properties of a specific category from the user's master category list. Use when you need details about a specific category.

Get message extensionReads only

Retrieve identifying details for a specific extension on a message in a user's mail folder. The response does not retain arbitrary custom extension properties.

Get message from child folderReads only

Tool to retrieve a specific message from a child folder within a user's mail folder hierarchy. Use when you need to access messages from nested folders where both parent and child folder IDs are known.

Get message MIME contentReads only

Tool to get the MIME content of a message. Use when you need to download the raw MIME format of an email message for analysis or archival.

Get Microsoft 365 group calendarReads only

Retrieve metadata for a Microsoft 365 group's default calendar using delegated work or school account access.

Get Microsoft 365 group eventReads only

Retrieve one calendar event owned by a Microsoft 365 group using delegated access.

Get Microsoft Graph groupReads only

Retrieve a Microsoft Graph group by ID.

Get Outlook profileReads only

Retrieves the Microsoft Outlook profile for a specified user.

Get Planner planReads only

Retrieve one Microsoft Planner plan by ID.

Get scheduleReads only

Retrieves free/busy schedule information for specified email addresses within a defined time window. Read-only; does not reserve time or prevent conflicts β€” verify availability before creating events.

Get specific calendarReads only

Retrieves a specific calendar by ID from the signed-in user's calendars. This tool is deprecated.

Get supported languagesReads only

Tool to retrieve supported languages in the user's mailbox. Use when you need to display or select from available mailbox languages.

Get supported time zonesReads only

Get the time zones supported for a user as configured on their mailbox server, using delegated authentication. Use when setting up an Outlook client or configuring user time zone preferences.

Get To Do taskReads only

Retrieve one Microsoft To Do task by its task-list and task IDs. Requires the Tasks.Read or Tasks.ReadWrite scope, which is not in Outlook's default scopes; the connection must grant it.

Get user by emailReads only

Retrieves user details from Microsoft Graph by email address (userPrincipalName). Returns user properties including display name, job title, department, and contact information. Use this action when you need to look up a user's profile information using their email address.

Get user calendar eventReads only

Tool to retrieve a specific calendar event from a user's primary calendar. Use when you need detailed information about a particular event for a given user.

Get user calendar group calendar permissionReads only

Tool to retrieve a specific calendar permission for a user's calendar within a calendar group. Use when you need to check access permissions for a specific calendar.

Get user calendar group eventReads only

Tool to retrieve a specific event from a user's calendar within a calendar group. Use when you need details of an event in a specific calendar group.

Get user calendar group event attachmentReads only

Tool to retrieve a specific attachment from an event within a calendar group for a user. Use when you need to access attachment content from a calendar event in a user's calendar group.

Get User Calendar Group ScheduleReads only

Retrieve free/busy availability for specified users, distribution lists, or resources over a time period using a user's calendar within a calendar group.

Get user calendar permissionReads only

Retrieve a specific permission for a user's default calendar, including the recipient or delegate and permission level.

Get user calendar permissionReads only

Tool to retrieve a specific calendar permission from a user's calendar. Use when you need to check who has access to a specific user's calendar and their permission level.

Get user child contact folderReads only

Tool to retrieve a specific child contact folder for a user by ID. Use when you need details of a child folder nested within a parent contact folder for a specific user.

Get user contact extensionReads only

Retrieve the identifying metadata of a specific open extension on a user's contact.

Get user event attachmentReads only

Tool to retrieve a specific attachment from a user's calendar event. Use when you need to access attachment details including content from a specific user's event.

Get user mail folder message ruleReads only

Tool to retrieve a specific message rule from a user's mail folder. Use when you need details about an email rule in a particular user's folder.

Get user message attachmentReads only

Tool to retrieve a specific attachment from a message in a mail folder hierarchy. Use when you need to get attachment details including content from a specific folder path.

Get user message extensionReads only

Retrieve the identifying metadata of a specific extension on a user's message.

Get user outlookReads only

Tool to retrieve the outlookUser object for a specified user. Use when you need to access the Outlook services entity for a user.

Get user's calendarReads only

Retrieves properties of a specific user's calendar by calendar ID, with optional property selection.

Get user's default calendarReads only

Retrieve properties of the default calendar for the signed-in user or a specified user.

List assigned Planner tasksReads only

List Microsoft Planner tasks assigned to the signed-in user.

List calendar event instancesReads only

Tool to retrieve instances (occurrences) of a recurring event from a specific calendar within a date range. Use when you need event instances from a particular calendar.

List calendar permissionsReads only

Tool to list calendar permissions for a specific calendar within a calendar group. Use when you need to view sharing permissions for a calendar.

List calendar view deltaReads only

Retrieve calendar-view delta events for a specified time range, including changes since a prior sync. Deleted entries do not retain their removal marker in the response.

List calendars in calendar groupReads only

Tool to retrieve calendars belonging to a specific calendar group. Use when you need to list calendars within a calendar group with optional OData queries.

List chat messagesReads only

Tool to list messages in a Teams chat. Use when you need message IDs to select a specific message for further actions.

List child folder messagesReads only

Tool to list messages from a child folder within a parent mail folder. Use when you need to retrieve messages from a subfolder that exists within another folder.

List child mail foldersReads only

List a mail folder's immediate child folders, with property projection and paging controls. Use this to navigate and inspect a nested mailbox folder hierarchy.

List contact folder child foldersReads only

Tool to list child folders under a specified contact folder. Use when navigating nested contact folder hierarchies or organizing contacts into subfolder structures.

List contact folders deltaReads only

Tool to get contact folders that have been added, deleted, or updated. Use when tracking changes to contact folder structure without fetching all folders each time.

List contacts deltaReads only

Retrieve incremental changes to contacts in a specified folder for synchronization. The initial sync may require paging before a delta link is returned; use the stored delta link for subsequent changes.

List direct group membershipsReads only

List Microsoft Entra groups the signed-in user directly belongs to.

List Email RulesReads only

List inbox email rules for the authenticated or specified user. Results may include rule conditions, actions, sequence, and stop-processing settings; use top and skip to page through rules, and narrow results client-side.

List event attachmentsReads only

Tool to list attachments for a specific Outlook calendar event. Use when you have an event ID and need to view its attachments.

List event calendar permissionsReads only

Tool to list calendar permissions for the calendar containing a specific event. Use when you need to see who has access to a calendar that contains a particular event.

List event instancesReads only

Tool to retrieve individual occurrences of a recurring calendar event within a specified time range. Use when you need to get specific instances of a recurring meeting or event series.

List event instancesReads only

Tool to list instances (occurrences) of a recurring event within a specified date range from a user's calendar in a calendar group. Use when you need to retrieve specific occurrences of a recurring event.

List event remindersReads only

Tool to retrieve reminders for events occurring within a specified time range. Use when you need to see upcoming reminders between two datetimes.

List eventsReads only

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.

List group conversation threadsReads only

List threads contained in one Microsoft 365 group conversation.

List group conversationsReads only

List conversation summaries in a Microsoft 365 group.

List group post attachmentsReads only

List attachments on one Microsoft 365 group conversation post. Requires a Group-Conversation.* or Group.* scope, which is not in Outlook's default scopes; the connection must grant it.

List group thread postsReads only

List posts in one Microsoft 365 group conversation thread.

List Inference Classification OverridesReads only

Tool to list inference classification overrides that control Focused Inbox sender rules. Use when you need to see which senders are configured to always appear in Focused or Other inbox.

List license detailsReads only

List the authenticated user's assigned Microsoft product licenses and service plans.

List mail folder message attachmentsReads only

Tool to get attachments from a message in a specific mail folder. Use when you need to retrieve attachment metadata from a message located in a particular folder.

List mail folder message rulesReads only

Tool to list message rules for a specific mail folder. Use when you need to retrieve rules configured for a particular folder.

List mail folder messagesReads only

Compatibility action that lists messages directly contained in one specified mail folder. It does not recursively include messages from descendant folders. Prefer OUTLOOK_LIST_MESSAGES for new calls; use this action only when its $expand support is required.

List mail foldersReads only

List a user's top-level Outlook mail folders with property projection, hidden-folder control, and paging. Use this to inspect the mailbox folder inventory or obtain folder IDs.

List mail folders deltaReads only

Retrieve incremental mail-folder changes for a mailbox using delta or continuation tokens. Deleted folder entries do not retain their deletion marker in the response.

List master categoriesReads only

Deprecated: Use OUTLOOK_GET_MASTER_CATEGORIES instead, which adds pagination (top/skip), filtering, field selection, and sorting.

List message attachments from child folderReads only

Tool to list attachments from a message in a nested child mail folder. Use when you need to retrieve attachment metadata from a message located in a subfolder.

List MessagesReads only

List or query Outlook messages in one folder (Inbox by default) or across the mailbox, with filters, search, field selection, sorting, and pagination. Some filters apply after each page is fetched, so empty pages can precede further results; search drops server-side filters, sorting, and offset.

List Microsoft 365 group calendar viewReads only

List occurrences, exceptions, and single events from a Microsoft 365 group's default calendar in a time window.

List notification subscriptionsReads only

List Microsoft Graph webhook subscriptions visible to the caller.

List organizationsReads only

List the connected Microsoft Entra tenant's organization profile. With User.Read, Microsoft returns only id, displayName, and verifiedDomains; request Organization.Read.All when other properties are needed.

List Outlook attachmentsReads only

List attachments for one Outlook email message. response_detail='minimal' returns projected metadata only; 'full' also returns base64 contentBytes for file attachments and can produce a large response. Returns fileAttachment, itemAttachment, and referenceAttachment records, including inline images and signatures. Only fileAttachment records can be downloaded with OUTLOOK_DOWNLOAD_OUTLOOK_ATTACHMENT. Results are under data.response_data.value.

List Outlook calendar groupsReads only

List calendar groups in the signed-in user's or a specified user's mailbox, with optional OData queries.

List Outlook calendarsReads only

List calendars in the signed-in user's or a specified user's mailbox, with optional OData queries.

List Outlook group threadsReads only

List conversation threads in a Microsoft 365 group with OData controls.

List placesReads only

Retrieves a collection of place objects defined in a tenant by type. Places can include rooms, workspaces, buildings, floors, sections, desks, and room lists. When room_list_id is provided, returns only rooms or workspaces within that specific room list using the /places/{roomListId}/microsoft.graph.roomlist/rooms (or /workspaces) endpoint. Use this action when you need to discover available physical spaces or locations within an organization. Note: Before using this API, ensure that the Places settings are properly configured in the tenant.

List Planner plan bucketsReads only

List one page of buckets belonging to a Microsoft Planner basic plan.

List primary calendar permissionsReads only

Tool to list calendar permissions from a user's primary calendar. Use when you need to see who has access to the primary calendar and their permission levels.

List sent items messagesReads only

List a page of messages in the SentItems folder of the signed-in user or a specified user's mailbox, with optional filtering and sorting. Use the returned continuation token to retrieve further pages.

List tasks from a To Do listReads only

Tool to list tasks within a specified Microsoft To Do task list, including status and due dates. Use when retrieving tasks from a specific To Do list.

List Teams chatsReads only

Tool to list Teams chats. Use when you need chat IDs and topics to select a chat for further actions.

List To Do task listsReads only

List Microsoft To Do task lists for the signed-in user or a specified user. Use to discover task lists before listing or creating tasks; results include list IDs and may include display names.

List user calendar event attachmentsReads only

Tool to list attachments for a calendar event within a specific calendar for a user. Use when you need to retrieve attachments from an event in a user's specific calendar.

List user calendar event attachmentsReads only

List a page of attachments for a specific event in a user's calendar. The response may include a next link when more results are available.

List user calendar group calendar eventsReads only

Tool to list events from a specific calendar within a calendar group for a user. Use when you need to retrieve events from a user's calendar that belongs to a specific calendar group.

List user calendar group event attachmentsReads only

Tool to list attachments for a calendar event within a specific calendar group for a user. Use when you need to retrieve attachments from an event in a calendar that belongs to a calendar group for a specific user.

List user calendar permissionsReads only

List sharing permissions and permission levels for a specific user's default calendar.

List user calendar permissionsReads only

Tool to list calendar permissions for a specific user's specific calendar. Use when you need to see who has access to a user's calendar and their permission levels.

List user calendars eventsReads only

Tool to retrieve events from a specific calendar for a user. Use when you need to list calendar events for a specific user by user ID and calendar ID.

List user child folder contactsReads only

Tool to retrieve contacts from a user's child contact folder. Use when you need to access contacts organized in nested folder structures for a specific user.

List user contact foldersReads only

Tool to retrieve contact folders from a specific user's mailbox. Use when you need to list or browse contact folders for a given user.

List user contactsReads only

Tool to retrieve contacts from a specific user's mailbox. Use when you need to list or browse contacts for a given user.

List usersReads only

List or search Microsoft Entra ID users by plain display name, exact email, or account-property filters. Multi-token name searches may return broader candidates, and results can include the signed-in user regardless of the requested filter, so verify matches before use. Use page tokens to continue through results; the maximum page size is 999.

Move child mail folder

Tool to move a child mail folder to a different parent folder. Use when you need to reorganize subfolders within the folder hierarchy.

Move mail folder

Tool to move a mail folder and its contents to another mail folder. Use when you need to reorganize the folder hierarchy.

Move message from child folder

Tool to move a message from a child folder to another destination folder. Use when you need to move a message that exists within a specific folder hierarchy (parent folder β†’ child folder β†’ message).

Move message from folder

Tool to move a message from a specific mail folder to another destination folder. Use when you need to move a message and know both the source folder ID and the message ID.

Move message to folder

Move a message to another folder within the specified user's mailbox. Immutable message IDs remain stable across moves within the mailbox. High-volume parallel moves can trigger HTTP 429 (MailboxConcurrency) throttling; honor the Retry-After header.

Permanently Delete Calendar

Permanently deletes a calendar from a user's mailbox. Unlike standard DELETE, this action makes the calendar permanently unrecoverable. Use when you need to ensure a calendar cannot be restored from deleted items.

Permanently Delete Calendar Group Event

Tool to permanently delete a calendar event from a calendar within a calendar group. Use when you need to ensure an event cannot be restored from deleted items.

Permanently Delete Child Contact Folder

Permanently deletes a child contact folder. Unlike standard DELETE, this action makes the folder permanently unrecoverable. Use when you need to ensure a child contact folder cannot be restored from deleted items.

Permanently Delete Child Mail Folder

Permanently deletes a child mail folder from a parent mail folder. Unlike standard DELETE, this action makes the folder permanently unrecoverable. Use when you need to ensure a child folder cannot be restored from deleted items.

Permanently Delete Contact

Permanently deletes a contact. Unlike standard DELETE, this action makes the contact permanently unrecoverable. Use when you need to ensure a contact cannot be restored from deleted items.

Permanently Delete Contact Folder

Permanently deletes a contact folder. Unlike standard DELETE, this action makes the folder permanently unrecoverable. Use when you need to ensure a contact folder cannot be restored from deleted items.

Permanently Delete Contact from Folder

Permanently deletes a contact from a specific contact folder. Unlike standard DELETE, this action makes the contact permanently unrecoverable. Use when you need to ensure a contact in a folder cannot be restored from deleted items.

Permanently Delete Event

Permanently deletes a calendar event. Unlike standard DELETE, this action makes the event permanently unrecoverable. Use when you need to ensure an event cannot be restored from deleted items.

Permanently Delete Message

Permanently deletes an Outlook message by moving it to the Purges folder in the dumpster. Unlike standard DELETE, this action makes the message unrecoverable by the user. IMPORTANT: This is NOT the same as DELETE - permanentDelete is irreversible and availability differs by national cloud deployments (not available in US Government L4, L5 (DOD), or China (21Vianet)).

Permanently Delete User Calendar Event

Tool to permanently delete a calendar event from a specific user's calendar. Use when you need to ensure an event cannot be restored from deleted items.

Permanently Delete User Contact from Child Folder

Tool to permanently delete a contact from a child folder for a specific user. Use when you need to ensure a contact cannot be restored from deleted items.

Permanently Delete User Event

Tool to permanently delete a calendar event for a specified user. Use when you need to ensure an event cannot be restored from deleted items.

Permanently Delete User Mail Folder

Permanently deletes a mail folder for a specific user. Unlike standard DELETE, this action makes the folder permanently unrecoverable. Use when you need to ensure a user's folder cannot be restored from deleted items.

Pin message

Tool to pin a message in an Outlook chat. Use when you want to mark an important message for quick access.

Query EmailsReads only

Query one Outlook mail folder using a validated OData filter, with field selection, sorting, offset, and continuation-token pagination. Requests up to 100 messages by default and up to 1,000 per page; sorting may be dropped if Graph rejects it as inefficient.

Reply all

Send a reply to every recipient selected by Outlook's reply-all semantics.

Reply to Email

Sends a reply to an Outlook email message with optional HTML formatting, attachments, CC, and BCC recipients.

Report message

Report a message as unknown, junk, not junk, or phishing. Reporting influences Microsoft's future mail filtering and cannot be retracted as an ordinary field update; when is_message_move_requested is true, Microsoft Graph can also move the message out of its current folder. On success, this beta operation may return either a command result with properties such as Status=Success or the message object documented by Microsoft Graph. The documented unknownFutureValue enum member is a forward-compatibility sentinel and is intentionally not exposed as a selectable report action. This action uses Microsoft Graph's beta API, which is subject to change and is not supported by Microsoft for production applications.

Search calendar eventsReads only

Searches for calendar events in the authenticated user's primary calendar. Work and school accounts use Microsoft Graph Search. When Microsoft Graph reports that Search is unsupported for a personal Microsoft account, the action searches a caller-supplied calendarView window locally by matching every whitespace-separated keyword across subject, body preview, location, and attendees.

Search Outlook messagesReads only

Search Outlook messages using KQL syntax. Supports Microsoft 365, work/school, and personal Microsoft accounts. Personal accounts use the Messages API fallback. Examples: 'from:user@example.com AND received>=2025-10-01', 'to:info@jcdn.nl AND subject:invoice', 'received>today-30 AND hasattachment:yes'

Search Outlook peopleReads only

List relevant people, optionally searching by fuzzy name or alias.

Search SharePoint sitesReads only

Search the connected Microsoft 365 tenant for SharePoint sites.

Send draft

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…'.

Send email

Sends an email with subject, body, recipients, and optional attachments via Microsoft Graph API. Supports comma-separated email addresses in the to_email field for multiple recipients. Accepts either a single file or a list of files as attachments. Attachments require a non-empty file with valid name and mimetype.

Snooze event reminder

Tool to postpone an event reminder until a new time. Use when you need to delay a reminder for a calendar event.

Snooze user calendar event reminder

Tool to snooze a reminder for a calendar event in a specific user calendar to a new time. Use when you need to postpone an event reminder for a specific calendar.

Snooze user calendar group event reminder

Tool to snooze a reminder for a user's calendar event within a calendar group to a new time. Use when you need to postpone an event reminder for a specific user's calendar that belongs to a calendar group.

Snooze user event reminder

Snoozes a reminder for an event in a user's default calendar to a new time.

Translate Exchange IDsReads only

Translate Outlook resource IDs between supported Exchange ID formats.

Update calendar event

Updates specified fields of an existing Outlook calendar event, including subject, time, attendees, location, categories, and recurrence.

Update calendar group

Tool to update the properties of a calendar group object. Use when you need to rename a calendar group.

Update Calendar Group Calendar Permission

Tool to update a calendar permission within a calendar group. Use when changing access levels for calendars in specific groups.

Update calendar permission

Tool to update calendar permission levels for share recipients or delegates. Use when you need to change the access level (role) for someone who has been granted access to a calendar.

Update child folder contact

Tool to update a contact in a child contact folder within a parent contact folder. Use when you need to modify contact properties such as name, email, phone numbers, or company details for contacts in nested folder structures.

Update Contact

Updates an existing Outlook contact, identified by `contact_id` for the specified `user_id`, requiring at least one other field to be modified.

Update contact extension

Tool to update an open extension on a contact in a contact folder. Use when you need to modify custom properties stored in a contact extension.

Update contact in folder

Tool to update a contact within a specific contact folder. Use when you need to modify contact details for a contact stored in a particular folder.

Update email message

Updates specified properties of an existing email message; `message_id` must identify a valid message within the specified `user_id`'s mailbox.

Update Email Rule

Update an existing email rule

Update event extension

Tool to update an open extension on a calendar event in Microsoft Graph. Use when you need to modify custom properties stored in an event extension.

Update event extension in calendar group

Tool to update an open extension on a calendar event within a calendar group. Use when modifying custom properties stored in an event extension for events in calendar groups.

Update event in specific calendar

Tool to update an event in a specific Outlook calendar. Use when you need to modify event details like subject, time, attendees, or location in a non-default calendar.

Update Inference Classification

Request an update to a user's Focused Inbox inference classification resource. This action cannot change classification settings or rules; manage message classification rules through the overrides collection.

Update mail folder

Tool to update the display name of a mail folder. Use when you need to rename an existing mail folder.

Update mailbox settings

Updates mailbox settings for the signed-in user or a specified user, including automatic replies, default time zone, language, and working hours.

Update master category

Tool to update the color of a category in the user's master category list. Use when you need to change the color of an existing category. Note that the display name cannot be modified after creation.

Update To Do checklist item

Update selected properties of one checklist item in a Microsoft To Do task. Requires the Tasks.ReadWrite scope, which is not in Outlook's default scopes; the connection must grant it.

Update To Do task

Updates an existing Microsoft To Do task's title, status, importance, due date, reminder, body, completion date, or categories. Providing a reminder date also enables the reminder.

Update user calendar

Update the name or color of a user's default calendar. At least one of these properties must be supplied.

Update user calendar by ID

Tool to update properties of a specific calendar by ID for a specific user. Use when you need to rename a user's calendar, change its color theme, or set it as the default calendar.

Update user calendar event

Update an event in a specified user's calendar by calendar ID and event ID. This tool is deprecated.

Update user calendar event

Tool to update an event in a specific user's calendar. Use when you need to modify calendar event properties for a user other than the signed-in user.

Update user calendar group event

Tool to update an event in a calendar within a calendar group for a specific user. Use when modifying event details for a user's calendar.

Update user calendar in calendar group

Tool to update a calendar within a calendar group in a user's mailbox. Use when modifying calendar properties like name, color, or default calendar status.

Update user calendar permission

Tool to update calendar permission levels for a specific user's calendar. Use when you need to change the access level (role) for someone who has been granted access to a user's calendar.

Update user child folder message

Tool to update a message in a child folder within a user's mailbox. Use when you need to modify message properties such as isRead status, importance, categories, or subject for messages in nested folder structures for a specific user.

Update user contact extension

Tool to update an open extension on a contact in a user's contact folder. Use when you need to modify custom properties stored in a contact extension for a specific user.

Update user contact extension

Updates an open extension on a contact in a child folder of a user's contact folder, including its custom properties.

Update user contact extension (v3)

Tool to update an open extension on a contact directly under a user's contacts collection. Use when you need to modify custom properties stored in a contact extension.

Update user contact folder

Tool to update the properties of a contact folder for a specific user. Use when you need to rename or move an existing contact folder.

Update user contact folder child folder

Tool to update a child folder within a contact folder for a specific user. Use when you need to rename a child contact folder or move it to a different parent folder.

Update user event extension

Update an open extension on a user's event in a calendar group, including its extension name and optional custom properties. This tool is deprecated.

Update user events extensions

Tool to update an open extension on a user's calendar event. Use when modifying custom properties stored in an event extension for a specific user.

Update User Inference Classification Override

Tool to update the classification of messages from a specific sender in a user's Focused Inbox. Use when you need to change whether messages from a sender go to Focused or Other inbox for a specific user.

Update user mail folder child folder

Tool to update a child folder within a mail folder for a specific user. Use when you need to rename a child mail folder.

Update user mail folder message

Tool to update properties of a message in a specific mail folder for a user. Use when you need to modify message attributes like categories, read status, importance, or other properties for a message within a particular user's folder.

Update user mail folder message rule

Tool to update a message rule in a user's mail folder. Use when you need to modify an existing rule's properties, conditions, actions, or exceptions for a specific user.

Update user message extension

Tool to update an open extension on a message within a specific user's mail folder. Use when you need to modify custom properties stored in a message extension for a specific user.

Update user message extension

Tool to update an open extension on a user's message. Use when you need to modify custom properties stored in a message extension for a specific user.

Who Am IReads only

Return the identity (email, name) of the connected Outlook account.

More in Email

See them all β†’

Your company, run by an AI team

Start your company

BRAINER

Continue to B.R.A.I.N.E.R.

Continue with Google or your email.

or