Outlook

tools

• OUTLOOK_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.

  in ▸ item name user_id event_id odata_type contentBytes

• OUTLOOK_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.

  in ▸ item name user_id isInline contentId message_id odata_type contentType contentBytes contentLocation

• OUTLOOK_CALENDAR_CREATE_EVENT

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

  in ▸ body is_html show_as subject user_id location time_zone categories end_datetime attendees_info start_datetime is_online_meeting online_meeting_provider

• OUTLOOK_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.

  in ▸ user_id message_id attachmentItem

• OUTLOOK_CREATE_CALENDAR

  Tool to create a new calendar in the signed-in user's mailbox. Use when organizing events into a separate calendar.

  in ▸ name color user_id hexColor

• OUTLOOK_CREATE_CONTACT

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

  in ▸ notes surname user_id birthday jobTitle givenName homePhone categories department companyName displayName mobilePhone businessPhones emailAddresses officeLocation

• OUTLOOK_CREATE_CONTACT_FOLDER

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

  in ▸ user_id displayName parentFolderId

• OUTLOOK_CREATE_DRAFT

  Creates an Outlook email draft with subject, body, recipients, and an optional attachment. Supports creating drafts as part of existing conversation threads by specifying a conversationId; attachments require a name, mimetype, and content.

  in ▸ body is_html subject attachment cc_recipients to_recipients bcc_recipients conversation_id

• OUTLOOK_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 `comment` and CC/BCC recipients.

  in ▸ comment user_id cc_emails bcc_emails message_id

• OUTLOOK_CREATE_EMAIL_RULE

  Create email rule filter with conditions and actions

  in ▸ actions sequence isEnabled conditions displayName

• OUTLOOK_CREATE_MAIL_FOLDER

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

  in ▸ user_id isHidden displayName

• OUTLOOK_CREATE_MASTER_CATEGORY

  Tool to create a new category in the user's master category list. Use after selecting a unique display name.

  in ▸ color displayName

• 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 the user specified by `user_id`.

  in ▸ user_id contact_id

• OUTLOOK_DELETE_EMAIL_RULE

  Delete an email rule

  in ▸ ruleId

• OUTLOOK_DELETE_EVENT

  Deletes an existing calendar event, identified by its unique `event_id`, from a specified user's Microsoft Outlook calendar, with an option to send cancellation notifications to attendees.

  in ▸ user_id event_id send_notifications

• OUTLOOK_DELETE_MAIL_FOLDER

  Delete a mail folder from the user's mailbox. Use when you need to remove an existing mail folder.

  in ▸ user_id folder_id

• OUTLOOK_DOWNLOAD_OUTLOOK_ATTACHMENT

  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.

  in ▸ user_id file_name message_id attachment_id

• OUTLOOK_GET_CALENDAR_VIEW

  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.

  in ▸ top select user_id timezone calendar_id end_datetime start_datetime

• OUTLOOK_GET_CONTACT

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

  in ▸ user_id contact_id

• OUTLOOK_GET_CONTACT_FOLDERS

  Tool to retrieve a list of contact folders in the signed-in user's mailbox. Use after authentication when you need to browse or select among contact folders.

  in ▸ top skip expand filter select orderby user_id

• OUTLOOK_GET_EVENT

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

  in ▸ user_id event_id

• OUTLOOK_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.

  in ▸ expand select user_id

• OUTLOOK_GET_MAIL_DELTA

  Retrieve incremental changes (delta) of messages in a mailbox. FIRST RUN: Returns ALL messages in folder (use top=50 to limit). Response has @odata.deltaLink. SUBSEQUENT: Pass stored deltaLink to get only NEW/UPDATED/DELETED messages since last sync. Properties available: id, subject, from, receivedDateTime, isRead, etc. NOT available: internetMessageHeaders, full body, attachment content (response size limits).

  in ▸ top expand select user_id folder_id skip_token delta_token

• OUTLOOK_GET_MAIL_TIPS

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

  in ▸ user_id EmailAddresses MailTipsOptions

• OUTLOOK_GET_MASTER_CATEGORIES

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

  in ▸ top skip filter select orderby user_id

• OUTLOOK_GET_MESSAGE

  Retrieves a specific email message by its ID from the specified user's Outlook mailbox. Use the 'select' parameter to include specific fields like 'internetMessageHeaders' for filtering automated emails.

  in ▸ select user_id message_id

• OUTLOOK_GET_PROFILE

  Retrieves the Microsoft Outlook profile for a specified user.

  in ▸ user_id

• OUTLOOK_GET_SCHEDULE

  Retrieves free/busy schedule information for specified email addresses within a defined time window.

  in ▸ EndTime Schedules StartTime availabilityViewInterval

• OUTLOOK_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.

  in ▸ user_id

• OUTLOOK_GET_SUPPORTED_TIME_ZONES

  Tool to retrieve supported time zones in the user's mailbox. Use when you need a list of time zones to display or choose from for event scheduling.

  in ▸ timeZoneStandard

• OUTLOOK_LIST_CALENDARS

  Tool to list calendars in the signed-in user's mailbox. Use when you need to retrieve calendars with optional OData queries.

  in ▸ top skip filter select orderby user_id

• OUTLOOK_LIST_CONTACTS

  Retrieves a user's Microsoft Outlook contacts, from the default or a specified contact folder.

  in ▸ top filter select orderby user_id contact_folder_id

• OUTLOOK_LIST_EMAIL_RULES

  List all email rules from inbox

  in ▸ top

• OUTLOOK_LIST_EVENTS

  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.

  in ▸ top skip filter select orderby user_id timezone calendar_id expand_recurring_events

• OUTLOOK_LIST_EVENT_ATTACHMENTS

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

  in ▸ top skip filter select orderby user_id event_id

• OUTLOOK_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.

  in ▸ user_id include_hidden_folders

• OUTLOOK_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 all messages in a thread), pagination, and sorting; ensure 'user_id' and 'folder' are valid, and all date/time strings are in ISO 8601 format.

  in ▸ top skip folder select is_read orderby subject user_id categories importance from_address conversationId has_attachments subject_contains subject_endswith sent_date_time_gt sent_date_time_lt subject_startswith received_date_time_ge received_date_time_gt received_date_time_le received_date_time_lt

• OUTLOOK_LIST_OUTLOOK_ATTACHMENTS

  Lists metadata (like name, size, and type, but not `contentBytes`) for all attachments of a specified Outlook email message.

  in ▸ user_id message_id

• OUTLOOK_LIST_REMINDERS

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

  in ▸ userId endDateTime startDateTime

• OUTLOOK_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.

  in ▸ top skip filter select

• OUTLOOK_MOVE_MESSAGE

  Move a message to another folder within the specified user's mailbox. This creates a new copy of the message in the destination folder and removes the original message.

  in ▸ user_id message_id destination_id

• OUTLOOK_QUERY_EMAILS

  Primary tool for querying Outlook emails with custom OData filters. Build precise server-side filters for dates, read status, importance, subjects, attachments, and conversations. Best for structured queries on message metadata. Returns up to 100 messages per request with pagination support. • Server-side filters: dates, importance, isRead, hasAttachments, subjects, conversationId • CRITICAL: Always check response['@odata.nextLink'] for pagination • Limitations: Recipient/sender/category filters require OUTLOOK_SEARCH_MESSAGES • For keyword/body search: Use OUTLOOK_SEARCH_MESSAGES (KQL syntax)

  in ▸ top skip filter folder select orderby user_id

• OUTLOOK_REPLY_EMAIL

  Sends a plain text reply to an Outlook email message, identified by `message_id`, allowing optional CC and BCC recipients.

  in ▸ comment user_id cc_emails bcc_emails message_id

• OUTLOOK_SEARCH_MESSAGES

  Search Outlook messages using powerful KQL syntax. Supports sender (from:), recipient (to:, cc:), subject, date filters (received:, sent:), attachments, and boolean logic. Only works with Microsoft 365/Enterprise accounts (no @hotmail.com/@outlook.com). Examples: 'from:user@example.com AND received>=2025-10-01', 'to:info@jcdn.nl AND subject:invoice', 'received>today-30 AND hasattachment:yes'

  in ▸ size query subject fromEmail from_index hasAttachments enable_top_results

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

  in ▸ user_id message_id

• OUTLOOK_SEND_EMAIL

  Sends an email with subject, body, recipients, and an optional attachment via Microsoft Graph API. Supports comma-separated email addresses in the to_email field for multiple recipients. Attachments require a non-empty file with valid name and mimetype.

  in ▸ body from is_html subject to_name user_id to_email cc_emails attachment bcc_emails save_to_sent_items

• OUTLOOK_UPDATE_CALENDAR_EVENT

  Updates specified fields of an existing Outlook calendar event. Implementation note: To avoid unintentionally clearing properties, the action first fetches the existing event, merges only the provided fields, and then PATCHes the merged updates. Unspecified fields remain unchanged.

  in ▸ body show_as subject user_id event_id location attendees time_zone categories end_datetime start_datetime

• OUTLOOK_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.

  in ▸ notes surname user_id birthday jobTitle givenName categories contact_id department homePhones companyName displayName mobilePhone businessPhones emailAddresses officeLocation

• OUTLOOK_UPDATE_EMAIL

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

  in ▸ body is_read subject user_id importance message_id cc_recipients to_recipients bcc_recipients

• OUTLOOK_UPDATE_EMAIL_RULE

  Update an existing email rule

  in ▸ ruleId actions sequence isEnabled conditions displayName

• OUTLOOK_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. Example: schedule automatic replies for vacation.

  in ▸ language timeZone workingHours automaticRepliesSetting