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 · 305 tools · 5 triggers

Connect it

run auth outlook
run auth outlook --scope team    # shared with the organization

Or from the Integrations page in the console. See Connections for personal versus shared, and who may remove one.

Use it

run outlook          # common commands
run outlook --all    # every command

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.

All 300 tools

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 →

Getting started

Guides

Integrations and automations

Use cases

References

Connect it

Use it

Common tools

Triggers (5)

​Connect it

​Use it

​Common tools

​Triggers (5)

Connect it

Use it

Common tools

Triggers (5)