> ## Documentation Index > Fetch the complete documentation index at: https://docs.boxd.sh/llms.txt > Use this file to discover all available pages before exploring further. # Outlook > Outlook is Microsoft's email and calendaring platform integrating contacts and scheduling, enabling users to manage communications and events in a unified workspace Outlook is Microsoft's email and calendaring platform integrating contacts and scheduling, enabling users to manage communications and events in a unified workspace `outlook` · **305 tools** · **5 triggers** ## Connect it ```bash theme={"theme":"github-dark"} run auth outlook run auth outlook --scope team # shared with the organization ``` Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one. ## Use it ```bash theme={"theme":"github-dark"} run outlook # common commands run outlook --all # every command ``` ```ts theme={"theme":"github-dark"} import { outlook } from "@boxd/run"; ``` ## Common tools | Tool | What it does | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `accept-event` | Accepts or tentatively accepts a calendar meeting invite on behalf of a user. | | `add-mail-attachment` | 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. | | `batch-move-messages` | Batch-move up to 20 Outlook messages to a destination folder in a single Microsoft Graph \$batch call. | | `batch-update-messages` | Batch-update up to 20 Outlook messages per call using Microsoft Graph JSON batching. | | `calendar-create-event` | Creates a new Outlook calendar event, ensuring `start_datetime` is chronologically before `end_datetime`. | | `copy-message` | Tool to copy an email message to another folder within the user's mailbox. | | `create-contact` | Creates a new contact in a Microsoft Outlook user's contacts folder. | | `create-draft` | Creates a new Outlook email draft with subject, body, recipients, and an optional attachment. | | `create-email-rule` | Create email rule filter with conditions and actions | | `create-task` | Tool to create a new task in Microsoft To Do within a specified task list. | | `decline-event` | Tool to decline an invitation to a calendar event. Use when the user wants to decline a meeting or event invitation. | | `delete-calendar` | Tool to delete a calendar other than the default calendar from a user's mailbox. | | `delete-mail-folder` | Delete a mail folder from the user's mailbox. Use when you need to remove an existing mail folder. | | `download-attachment` | Downloads a specific file attachment from an email message in a Microsoft Outlook mailbox; the attachment must contain 'contentBytes' (binary data)... | | `find-meeting-times` | Suggests meeting times based on organizer and attendee availability, time constraints, and duration requirements. | | `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. | | `get-calendar-view` | Get events ACTIVE during a time window (includes multi-day events). | | `get-event` | Retrieves the full details of a specific calendar event by its ID from a user's Outlook calendar, provided the event exists. | | `get-mail-delta` | Retrieve incremental changes (delta) of messages in a mailbox. | | `get-mail-tips` | Tool to retrieve mail tips such as automatic replies and mailbox full status. | | `get-me-contacts` | 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-profile` | Retrieves the Microsoft Outlook profile for a specified user. | | `get-user-by-email` | Retrieves user details from Microsoft Graph by email address (userPrincipalName). | | `get-user-calendar-event` | Tool to retrieve a specific calendar event from a user's primary calendar. | | Tool | What it does | | ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `accept-event` | Accepts or tentatively accepts a calendar meeting invite on behalf of a user. | | `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` | 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. | | `batch-move-messages` | Batch-move up to 20 Outlook messages to a destination folder in a single Microsoft Graph \$batch call. | | `batch-update-messages` | Batch-update up to 20 Outlook messages per call using Microsoft Graph JSON batching. | | `calendar-create-event` | Creates a new Outlook calendar event, ensuring `start_datetime` is chronologically before `end_datetime`. | | `cancel-calendar-event` | Tool to cancel an event in a specific calendar for a specified user and send cancellation notifications to all attendees. | | `cancel-calendar-group-calendar-event` | Tool to cancel an event in a user's calendar within a calendar group and send cancellation notifications to all attendees. | | `cancel-event` | Tool to cancel a calendar event for a specified user and send cancellation notifications to all attendees. | | `copy-mail-folder` | Tool to copy a user's mail folder and its contents to another folder. | | `copy-me-mail-folder` | Tool to copy a child mail folder to a destination folder. Use when you need to duplicate a folder structure. | | `copy-message` | Tool to copy an email message to another folder within 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. | | `copy-message-from-mail-folder` | Tool to copy a message from a specific user's mail folder to another folder. | | `create-attachment-upload-session` | Tool to create an upload session for large (>3 MB) message attachments. | | `create-attachment-upload-session-in-child-folder` | Tool to create an upload session for large (>3 MB) message attachments in child mail folders. | | `create-calendar` | Tool to create a new calendar in the signed-in user's mailbox. | | `create-calendar-event` | DEPRECATED: Use OUTLOOK\_CREATE\_USER\_CALENDAR\_CALENDAR\_EVENT instead. | | `create-calendar-event-attachment` | Tool to create a new attachment for an event in a specific calendar. | | `create-calendar-event-attachment-upload-session` | Tool to create an upload session for large calendar event attachments in a specific calendar. | | `create-calendar-event-in-calendar` | Tool to create a new event in a specific calendar for a user. | | `create-calendar-group` | Tool to create a new calendar group for a user. Use when needing to organize calendars into groups. | | `create-calendar-group-calendar-event-attachment` | Tool to create a new attachment for an event in a calendar within a calendar group for a specific user. | | `create-calendar-group-calendar-event-extension` | Tool to create a new open extension on a calendar event within a specific calendar group and calendar. | | `create-calendar-permission` | Tool to create a calendar permission for a specific calendar in a calendar group. | | `create-cal-group-event-attach-upload` | Tool to create an upload session for large calendar group event attachments. | | `create-contact` | Creates a new contact in a Microsoft Outlook user's contacts folder. | | `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-folder-child-folder` | Tool to create a child contact folder within a parent contact folder for a specific user. | | `create-draft` | Creates a new Outlook email draft with subject, body, recipients, and an optional attachment. | | `create-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... | | `create-email-rule` | Create email rule filter with conditions and actions | | `create-event-attachment` | Tool to create a new attachment for a user's calendar event. | | `create-event-attachment-upload-session` | Tool to create an upload session for large calendar event attachments. | | `create-forward-draft` | Tool to create a forward draft of an Outlook message for a specific user. | | `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` | 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-mail-folder-message-attachment` | Tool to add an attachment to a message in a specific 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. | | `create-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-master-category` | DEPRECATED: Use OUTLOOK\_CREATE\_USER\_MASTER\_CATEGORY instead. | | `create-me-calendar-event-extension` | Tool to create a new open extension on a calendar event for a specific user. | | `create-me-calendar-permission` | Tool to create a new calendar permission for a specific user's calendar. | | `create-me-child-folder-message` | Tool to create a new draft message in a child folder within a user's mail folder. | | `create-me-contact-folders-contacts` | Tool to create a new contact in a specific user's contact folder. | | `create-me-contact-folders-contacts-extensions` | Tool to create a new open extension on a contact within a user's contact folder. | | `create-me-contact-folders-extensions` | Tool to create a new open extension on a contact within a child folder. | | `create-me-contact-in-child-folder` | Tool to create a new contact in a child folder within a contact folder. | | `create-me-event` | Tool to create a new calendar event for a specific user. Use when you need to create events in a user's calendar. | | `create-me-event-attachment-upload-session` | Tool to create an upload session for large event attachments. | | `create-me-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. | | `create-me-inference-classification-override` | Tool to create a Focused Inbox override for a sender identified by SMTP address for a specific user. | | `create-me-mail-folder-message-reply-all-draft` | Deprecated: Use OUTLOOK\_CREATE\_REPLY\_ALL\_DRAFT instead, which supports both /me and /users/\{user\_id} endpoints with timezone support. | | `create-me-message-reply-all-draft` | 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-me-reply-all-draft` | Tool to create a draft reply-all to a message in a child folder. | | `create-me-reply-draft` | Deprecated: Use OUTLOOK\_CREATE\_DRAFT\_REPLY instead, which adds comment, cc\_emails, and bcc\_emails support. | | `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. | | `create-reply-all-draft` | Tool to create a reply-all draft for a message in a mail folder. | | `create-task` | Tool to create a new task in Microsoft To Do within a specified task list. | | `create-user-calendar-event-attachment` | Tool to create a new attachment for an event in a specific user's calendar. | | `create-user-calendar-group-calendar` | Tool to create a new calendar in a calendar group for a specific user. | | `create-user-calendar-group-event` | Tool to create a new calendar event in a specific user's calendar within a calendar group. | | `create-user-contacts-extensions` | Tool to create a new open extension on a specific user's contact. | | `create-user-event-attachment-upload-session` | Deprecated: Use OUTLOOK\_CREATE\_ME\_EVENT\_ATTACHMENT\_UPLOAD\_SESSION instead, which supports both /me and /users/\{user\_id} endpoints. | | `create-user-event-calendar-permission` | Tool to create a calendar permission via an event's calendar. | | `create-user-mail-child-folder-msg-ext` | Tool to create a new open extension on a message in a child mail folder for any user. | | `create-user-mail-folder-message-extension` | Tool to create a new open extension on a message in a user's mail folder. | | `create-user-mail-folder-message-reply-draft` | Tool to create a reply draft for a message in a user's mail folder. | | `create-user-mail-folders-child-folders` | Tool to create a new child folder under a specified mail folder for a user. | | `create-user-master-category` | Tool to create a new category in a user's master category list. | | `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. | | `decline-event` | Tool to decline an invitation to a calendar event. Use when the user wants to decline a meeting or event invitation. | | `delete-calendar` | Tool to delete a calendar other than the default calendar from a user's mailbox. | | `delete-calendar-event` | Tool to delete a calendar event from a user's Outlook calendar. | | `delete-calendar-event-attachment` | Tool to delete an attachment from an event in a specific user's calendar. | | `delete-calendar-event-from-specific-calendar` | Tool to delete an event from a specific calendar in Outlook. | | `delete-calendar-from-group` | Tool to delete a calendar from a specific user's calendar group in Microsoft Outlook. | | `delete-calendar-group` | Tool to delete a calendar group other than the default calendar group. | | `delete-calendar-group-calendar-event` | Tool to delete a calendar event from a specific user's calendar within a calendar group. | | `delete-calendar-group-event-attachment` | Tool to delete an attachment from an event in a calendar within a calendar group. | | `delete-calendar-group-event-permanently` | Tool to permanently delete a calendar event from a calendar within a calendar group. | | `delete-calendar-permanently` | Permanently deletes a calendar from a user's mailbox. Unlike standard DELETE, this action makes the calendar permanently unrecoverable. | | `delete-calendar-permission` | Tool to delete a calendar permission from a user's calendar within a calendar group. | | `delete-child-contact-folder-permanently` | Permanently deletes a child contact folder. Unlike standard DELETE, this action makes the folder permanently unrecoverable. | | `delete-child-folder-message` | Tool to delete a message from a child mail folder in Outlook. | | `delete-contact` | Permanently deletes an existing contact, using its `contact_id` (obtainable via 'List User Contacts' or 'Get Contact'), from the Outlook contacts of... | | `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-folder-child-folder` | Tool to delete a child contact folder from a parent contact folder for a specific user. | | `delete-contact-folder-contact` | Tool to permanently delete a contact from a specific contact folder. | | `delete-contact-folder-permanently` | Permanently deletes a contact folder. Unlike standard DELETE, this action makes the folder permanently unrecoverable. | | `delete-contact-from-child-folder-permanently` | Tool to permanently delete a contact from a child folder for a specific user. | | `delete-contact-from-folder-permanently` | Permanently deletes a contact from a specific contact folder. | | `delete-contact-permanently` | Permanently deletes a contact. Unlike standard DELETE, this action makes the contact permanently unrecoverable. | | `delete-contacts-extensions` | Tool to delete a navigation property extension from a contact within a child folder. | | `delete-email-rule` | Delete an email rule permanently; deletion is irreversible. Confirm rule details with the user before executing. | | `delete-event` | DEPRECATED: Use OUTLOOK\_DELETE\_CALENDAR\_EVENT instead. Tool to delete an event from the user's calendar. | | `delete-event-attachment` | Tool to delete an attachment from an Outlook calendar event. | | `delete-event-extension` | Tool to delete an open extension from a calendar event in a calendar group. | | `delete-event-permanently` | Permanently deletes a calendar event. Unlike standard DELETE, this action makes the event permanently unrecoverable. | | `delete-mail-folder` | Delete a mail folder from the user's mailbox. Use when you need to remove an existing mail folder. | | `delete-mail-folder-message` | Tool to delete a message from a specific mail folder in Outlook. | | `delete-master-category` | Tool to delete a category from the user's master category list. | | `delete-me-calendar-permission` | Tool to delete a calendar permission from a specific user's calendar. | | `delete-me-contact-extension` | Tool to delete an open extension from a contact. Use when removing custom data extensions that are no longer needed. | | `delete-me-contact-folder-contact-extension` | Tool to delete an extension from a contact in a user's contact folder. | | `delete-me-event-extension` | Tool to delete an open extension from a user's calendar event. | | `delete-me-events-attachments` | 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-me-inference-classification-override` | Tool to delete an inference classification override for a specific sender. | | `delete-me-mail-folder-child-folder` | Tool to delete a child mail folder from a parent mail folder. | | `delete-me-mail-folder-child-folder-permanently` | Permanently deletes a child mail folder from a parent mail folder. | | `delete-me-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-me-mail-folders-child-folders-messages-extens` | Delete user message extension | | `delete-me-mail-folders-messages-attachments` | DEPRECATED: Use OUTLOOK\_DELETE\_MESSAGE\_ATTACHMENT instead. Tool to delete an attachment from a message in a mail folder. | | `delete-me-mail-folders-messages-extensions` | Tool to delete a navigation property extension from a message within a mail folder. | | `delete-me-messages-attachments` | Tool to delete an attachment from a message. Use when removing file or item attachments from messages in Outlook. | | `delete-message` | Tool to permanently delete an Outlook email message by its message\_id. | | `delete-message-attachment` | Tool to delete an attachment from a message in a nested mail folder structure. | | `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-message-permanently-from-folder` | DEPRECATED: Use OUTLOOK\_PERMANENT\_DELETE\_MESSAGE instead. Tool to permanently delete a message from a specific mail folder. | | `delete-primary-calendar-permission` | Tool to delete a calendar permission from a specific user's calendar. | | `delete-todo-task` | Tool to permanently delete a task from a Microsoft To Do task list. | | `delete-user-calendar-event-permanently` | Tool to permanently delete a calendar event from a specific user's calendar. | | `delete-user-child-folder-contact` | Tool to delete a contact from a child folder in a user's contact folder. | | `delete-user-child-folder-message-permanently` | Tool to permanently delete a message from a user's child mail folder in Outlook. | | `delete-user-contact-extension` | Deprecated: Use OUTLOOK\_DELETE\_CONTACTS\_EXTENSIONS instead, which supports both /me and /users/\{user\_id} endpoints. | | `delete-user-event-permanently` | Tool to permanently delete a calendar event for a specified user. | | `delete-user-mail-folder-permanently` | Permanently deletes a mail folder for a specific user. Unlike standard DELETE, this action makes the folder permanently unrecoverable. | | `delete-user-message-attachment` | Deprecated: Use OUTLOOK\_DELETE\_ME\_MESSAGES\_ATTACHMENTS instead, which supports both /me and /users/\{user\_id} endpoints. | | `dismiss-calendar-event-reminder` | Tool to dismiss a reminder for a specific event in a user's calendar. | | `dismiss-event-reminder` | Tool to dismiss a reminder for a specific calendar event. Use when you need to turn off or remove a reminder alert for an event. | | `dismiss-event-reminder-from-group` | Tool to dismiss a reminder for an event in a user's calendar within a calendar group. | | `dismiss-user-event-reminder` | Tool to dismiss a reminder for a specific user's calendar event. | | `download-attachment` | Downloads a specific file attachment from an email message in a Microsoft Outlook mailbox; the attachment must contain 'contentBytes' (binary data)... | | `find-meeting-times` | Suggests meeting times based on organizer and attendee availability, time constraints, and duration requirements. | | `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. | | `get-calendar` | Deprecated: Use OUTLOOK\_GET\_USER\_CALENDAR instead, which supports both /me and /users/\{user\_id} endpoints and adds \$select field filtering. | | `get-calendar-event` | Tool to retrieve a specific event from a specified calendar. | | `get-calendar-event-attachment` | Tool to retrieve a specific attachment from an event within a calendar. | | `get-calendar-from-event` | Tool to retrieve the parent calendar that contains a specific event. | | `get-calendar-from-group` | Tool to retrieve a specific calendar from a calendar group in Microsoft Outlook. | | `get-calendar-group` | Tool to retrieve the properties and relationships of a calendar group object. | | `get-calendar-group-calendar-event-extension` | Tool to retrieve an open extension from a calendar event within a specific calendar group and calendar. | | `get-calendar-group-event-attachment` | Deprecated: Use OUTLOOK\_GET\_USER\_CALENDAR\_GROUP\_EVENT\_ATTACHMENT instead, which supports both /me and /users/\{user\_id} endpoints. | | `get-calendar-group-schedule` | Tool to retrieve free/busy schedule information for a specific user's calendar within a calendar group. | | `get-calendar-permission` | Tool to retrieve a specific calendar permission for a user's calendar. | | `get-calendar-permission-from-calendar` | Tool to retrieve a specific calendar permission from a user's calendar. | | `get-calendar-schedule` | Tool to get free/busy schedule information for users, distribution lists, or resources. | | `get-calendar-view` | Get events ACTIVE during a time window (includes multi-day events). | | `get-child-folder-message` | Tool to retrieve a specific email message from a child mail folder. | | `get-child-folder-message-content` | Tool to get the MIME content of a message from a child mail folder. | | `get-child-mail-folder` | Tool to retrieve a specific child mail folder from a parent mail folder. | | `get-contact-extension` | Tool to retrieve an open extension from a contact in Microsoft Graph. | | `get-contact-folder` | 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-folders` | Tool to retrieve contact folders from a specific user's mailbox. | | `get-contact-from-folder` | Tool to retrieve a specific contact from a contact folder by its ID. | | `get-drafts-mail-folder` | 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-event` | Retrieves the full details of a specific calendar event by its ID from a user's Outlook calendar, provided the event exists. | | `get-event-attachment` | Tool to retrieve a specific attachment from an Outlook calendar event by attachment ID. | | `get-event-calendar-from-group` | Tool to retrieve the calendar that contains a specific event within a calendar group. | | `get-inference-classification` | Tool to get inference classification settings for the authenticated user. | | `get-mailbox-settings` | 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-mail-delta` | Retrieve incremental changes (delta) of messages in a mailbox. | | `get-mail-folder` | Tool to retrieve a mail folder by ID or well-known name. Use when you need to get details about a specific folder such as item counts, size, and folder properties. | | `get-mail-folder-message` | Tool to retrieve a specific message from a mail folder by its ID. | | `get-mail-folder-message-rule` | Tool to retrieve a specific message rule from a user's mail folder. | | `get-mail-tips` | Tool to retrieve mail tips such as automatic replies and mailbox full status. | | `get-master-categories` | Tool to retrieve the user's master category list. Use when you need to get all categories defined for the user. | | `get-master-category` | Tool to retrieve properties of a specific category from the user's master category list. | | `get-me-calendar` | Tool to get the properties and relationships of the signed-in user's default calendar. | | `get-me-contact-folders-child-folder` | Tool to retrieve a specific child contact folder for a user by ID. | | `get-me-contact-from-child-folder` | Tool to retrieve a specific contact from a nested child folder within a contact folder. | | `get-me-contact-photo` | Tool to get the binary media content of a contact's profile photo. | | `get-me-contacts` | 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-me-contacts-extensions` | Tool to retrieve a specific open extension from a user's contact. | | `get-me-event-attachment` | Tool to retrieve a specific attachment from a user's calendar event. | | `get-me-event-calendar` | Tool to retrieve the calendar that contains a specific event. | | `get-me-mail-folder-message-attachment` | DEPRECATED: Use OUTLOOK\_GET\_USER\_MESSAGES\_ATTACHMENTS instead. | | `get-me-mail-folders-messages-extensions` | Tool to retrieve a specific extension from a message in a user's mailbox. | | `get-me-message-mime-content` | 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-me-outlook` | Tool to retrieve the outlookUser object for a specified user. | | `get-message` | Retrieves a specific email message by its ID from the specified user's Outlook mailbox. | | `get-message-extension` | Tool to retrieve a specific extension from a user's message. | | `get-nested-folder-message-attachment` | Tool to retrieve a specific attachment from a message located in a nested mail folder structure. | | `get-profile` | Retrieves the Microsoft Outlook profile for a specified user. | | `get-schedule` | Retrieves free/busy schedule information for specified email addresses within a defined time window. | | `get-supported-languages` | 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-zones` | Tool to get the list of time zones supported for a user as configured on their mailbox server. | | `get-user-by-email` | Retrieves user details from Microsoft Graph by email address (userPrincipalName). | | `get-user-calendar` | Tool to get the properties and relationships of a specific calendar for a user. | | `get-user-calendar-allowed-sharing-roles` | Tool to retrieve allowed calendar sharing roles for a specific user on a given calendar. | | `get-user-calendar-event` | Tool to retrieve a specific calendar event from a user's primary calendar. | | `get-user-calendar-group-calendar-permission` | Tool to retrieve a specific calendar permission for a user's calendar within a calendar group. | | `get-user-calendar-group-event` | Tool to retrieve a specific event from a user's calendar within a calendar group. | | `get-user-calendar-group-event-attachment` | Tool to retrieve a specific attachment from an event within a calendar group for a user. | | `get-user-child-folder-message` | Tool to retrieve a specific message from a child folder within a user's mail folder hierarchy. | | `get-user-event-extension` | Tool to retrieve a specific open type extension from a user's calendar event by its extension ID or name. | | `get-user-messages-attachments` | Tool to retrieve a specific attachment from a message in a mail folder hierarchy. | | `list-calendar-calendar-view` | DEPRECATED: Use OUTLOOK\_LIST\_ME\_CALENDARS\_CALENDAR\_VIEW instead. | | `list-calendar-event-attachments` | Tool to list attachments for a calendar event within a specific calendar for a user. | | `list-calendar-group-calendar-events` | Tool to list events from a specific calendar within a calendar group for a user. | | `list-calendar-group-calendars` | Tool to retrieve calendars belonging to a specific calendar group. | | `list-calendar-group-event-attachments` | Tool to list attachments for a calendar event within a specific calendar group for a user. | | `list-calendar-groups` | Tool to list calendar groups in the signed-in user's mailbox. | | `list-calendar-permissions` | Tool to list calendar permissions for a specific calendar within a calendar group. | | `list-calendars` | Tool to list calendars in the signed-in user's mailbox. Use when you need to retrieve calendars with optional OData queries. | | `list-calendar-view-delta` | Tool to get calendar events that have been added, deleted, or updated in a calendar view. | | `list-chat-messages` | Tool to list messages in a Teams chat. Use when you need message IDs to select a specific message for further actions. | | `list-chats` | Tool to list Teams chats. Use when you need chat IDs and topics to select a chat for further actions. | | `list-child-folder-contacts` | Tool to retrieve contacts from a user's child contact folder. | | `list-child-folder-messages` | Tool to list messages from a child folder within a parent mail folder. | | `list-child-mail-folders` | Tool to list subfolders (childFolders) under a specified Outlook mail folder. | | `list-contact-folder-child-folders` | Tool to list child folders under a specified contact folder. | | `list-contact-folders-delta` | Tool to get contact folders that have been added, deleted, or updated. | | `list-contacts` | DEPRECATED: Use OUTLOOK\_LIST\_USER\_CONTACTS instead. Retrieves a user's Microsoft Outlook contacts, from the default or a specified contact folder. | | `list-contacts-delta` | Retrieve incremental changes (delta) of contacts in a specified folder. | | `list-email-rules` | List all email rules from inbox. No server-side filtering is supported; all rule narrowing must be done client-side after retrieval. | | `list-event-attachments` | Tool to list attachments for a specific Outlook calendar event. | | `list-event-calendar-calendar-permissions` | Tool to list calendar permissions for the calendar containing a specific event. | | `list-event-instances` | Tool to retrieve individual occurrences of a recurring calendar event within a specified time range. | | `list-events` | Retrieves events from a user's Outlook calendar via Microsoft Graph API. | | `list-inference-classification-overrides` | Tool to list inference classification overrides that control Focused Inbox sender rules. | | `list-mail-folder-message-attachments` | Tool to get attachments from a message in a specific mail folder. | | `list-mail-folder-message-rules` | 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-messages` | Tool to list messages from a specific mail folder including subfolders. | | `list-mail-folders` | 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. | | `list-mail-folders-delta` | Tool to get incremental changes to mail folders. Use when you need to track additions, deletions, or updates to mail folders without fetching the... | | `list-master-categories` | Deprecated: Use OUTLOOK\_GET\_MASTER\_CATEGORIES instead, which adds pagination (top/skip), filtering, field selection, and sorting. | | `list-me-calendar-permissions` | Tool to list calendar permissions for a specific user's calendar. | | `list-me-event-instances` | DEPRECATED: Use OUTLOOK\_LIST\_EVENT\_INSTANCES instead. Tool to retrieve individual occurrences of a recurring calendar event within a specified time range. | | `list-message-attachments-from-child-folder` | Tool to list attachments from a message in a nested child mail folder. | | `list-messages` | Retrieves a list of email messages from a specified mail folder in an Outlook mailbox, with options for filtering (including by conversationId to get... | | `list-attachments` | Lists metadata (name, size, contentType, isInline - but not `contentBytes`) for all attachments of a specified Outlook email message. | | `list-places` | Retrieves a collection of place objects defined in a tenant by type. | | `list-primary-calendar-permissions` | Tool to list calendar permissions from a user's primary calendar. | | `list-reminders` | Tool to retrieve reminders for events occurring within a specified time range. | | `list-sent-items-messages` | Tool to list all messages in the SentItems mail folder of the signed-in user's mailbox. | | `list-to-do-lists` | Tool to list Microsoft To Do task lists for the signed-in user. | | `list-todo-tasks` | Tool to list tasks within a specified Microsoft To Do task list, including status and due dates. | | `list-user-calendar-event-instances` | Tool to retrieve instances (occurrences) of a recurring event from a specific calendar within a date range. | | `list-user-calendar-events-attachments` | Tool to list attachments for a user's calendar event. Use when you need to retrieve all attachments from a specific event in a user's calendar. | | `list-user-calendar-group-event-instances` | Tool to list instances (occurrences) of a recurring event within a specified date range from a user's calendar in a calendar group. | | `list-user-calendar-groups-calendar-view` | Tool to get calendar view from a specific calendar within a calendar group for a user. | | `list-user-calendars-calendar-permissions` | Tool to list calendar permissions for a specific user's specific calendar. | | `list-user-calendars-events` | Tool to retrieve events from a specific calendar for a user. | | `list-user-calendar-view` | 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\... | | `list-user-contacts` | Tool to retrieve contacts from a specific user's mailbox. Use when you need to list or browse contacts for a given user. | | `list-users` | 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. | | `move-mail-folder` | Tool to move a mail folder and its contents to another mail folder. | | `move-me-mail-folder` | Tool to move a child mail folder to a different parent folder. | | `move-message` | Move a message to another folder within the specified user's mailbox. | | `move-message-from-child-folder` | Tool to move a message from a child folder to another destination folder. | | `move-message-from-folder` | Tool to move a message from a specific mail folder to another destination folder. | | `permanent-delete-message` | Permanently deletes an Outlook message by moving it to the Purges folder in the dumpster. | | `pin-message` | Tool to pin a message in an Outlook chat. Use when you want to mark an important message for quick access. | | `query-emails` | Query Outlook emails within a SINGLE folder using OData filters. | | `reply-email` | Sends a reply to an Outlook email message with optional HTML formatting, attachments, CC, and BCC recipients. | | `search-events` | Searches for calendar events in the authenticated user's primary calendar using the Microsoft Graph Search API. | | `search-messages` | Search Outlook messages using powerful KQL syntax. Supports sender (from:), recipient (to:, cc:), subject, date filters (received:, sent:)... | | `send-draft` | Tool to send an existing draft message. Use after creating a draft when you want to deliver it to recipients immediately. | | `send-email` | Sends an email with subject, body, recipients, and optional attachments via Microsoft Graph API. | | `snooze-calendar-group-event-reminder` | Tool to snooze a reminder for a user's calendar event within a calendar group to a new time. | | `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. | | `snooze-user-event-reminder` | Tool to snooze a reminder for a user's calendar event to a new time. | | `update-calendar-event` | Updates specified fields of an existing Outlook calendar event. | | `update-calendar-event-in-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-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. | | `update-calendar-groups-calendars` | Tool to update a calendar within a calendar group in a user's mailbox. | | `update-calendar-groups-calendars-events` | Tool to update an event in a calendar within a calendar group for a specific user. | | `update-calendar-permission` | Tool to update calendar permission levels for share recipients or delegates. | | `update-child-folder-contact` | Tool to update a contact in a child contact folder within a parent contact folder. | | `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-folder` | Tool to update the properties of a contact folder for a specific user. | | `update-contact-folder-child-folder` | Tool to update a child folder within a contact folder for a specific user. | | `update-contact-folders-contacts` | 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` | 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. | | `update-event-extension-in-calendar-group` | Tool to update an open extension on a calendar event within a calendar group. | | `update-inference-classification` | Tool to update the inferenceClassification resource for a user. | | `update-mailbox-settings` | 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. | | `update-mail-folder` | Tool to update the display name of a mail folder. Use when you need to rename an existing mail folder. | | `update-master-category` | Tool to update the color of a category in the user's master category list. | | `update-me-contacts-extensions` | Tool to update an open extension on a contact in a contact folder. | | `update-todo-task` | Tool to update an existing task in Microsoft To Do. Use when modifying a task's title, status, importance, due date, reminder, body, or categories. | | `update-user-calendar` | Tool to update the properties of a user's calendar. Use when you need to rename a calendar or change its color theme for a specific user. | | `update-user-calendar-calendar-event` | Deprecated: Use OUTLOOK\_UPDATE\_CALENDAR\_EVENT\_IN\_CALENDAR instead, which supports both /me and /users/\{user\_id} endpoints and additional fields... | | `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-permission` | Tool to update calendar permission levels for a specific user's calendar. | | `update-user-calendars` | Tool to update properties of a specific calendar by ID for a specific user. | | `update-user-child-folder-message` | Tool to update a message in a child folder within a user's mailbox. | | `update-user-contact-extension` | Tool to update an open extension on a contact in a user's contact folder. | | `update-user-contacts-extensions` | Tool to update an open extension on a contact in a user's contact folder. | | `update-user-contacts-extensions-direct` | Tool to update an open extension on a contact directly under a user's contacts collection. | | `update-user-event-extension` | Deprecated: Use OUTLOOK\_UPDATE\_EVENT\_EXTENSION\_IN\_CALENDAR\_GROUP instead, which supports both /me and /users/\{user\_id} endpoints and uses the correct @odata.type prefix. | | `update-user-events-extensions` | Tool to update an open extension on a user's calendar event. | | `update-user-inference-classification-override` | Tool to update the classification of messages from a specific sender in a user's Focused Inbox. | ## Triggers (5) Subscribe with `.on(...)` in a script. A trigger with required configuration takes it as the second argument. | Trigger | Needs | What fires it | | ---------------------- | ------- | -------------------------------------------------------------------------------------------------- | | New Contact Added | nothing | Triggered when a new contact is added in the Outlook contacts. | | Calendar Event Changes | nothing | Triggered when a new calendar event occurs (created, updated, or deleted) in the Outlook calendar. | | New Calendar Event | nothing | Triggered when a new calendar event is created in the Outlook calendar. | | New Outlook Message | nothing | Triggered when a new message is received in the Outlook mailbox. | | New Sent Message | nothing | Triggered when a new message is sent from the Outlook mailbox. | [Open Outlook in the console →](https://app.boxd.sh/integrations/detail/outlook)