Outlook Mail
API integration

outlook_list_emails

List Outlook messages in the connected mailbox (or optional user_id). Use when browsing inbox mail or finding messages before get/reply/forward. Prefer folder messages list when scoped to a specific mail folder. Results are summaries; fetch a full record via this resource's get method. Returns one page; pass the response's next_cursor to fetch subsequent pages.

outlook_get_email

Read a single Outlook message including subject, body, and recipients. Use when you know the message id and need its content to summarize or reply. Obtain id from messages or folder messages.

outlook_create_draft

Create an Outlook draft in the Drafts folder (does not send). Use when composing mail to review later. To send immediately without a draft, use messages send-mail. To send this draft later, use messages send-draft.

outlook_update_email

Update an existing Outlook message or draft (subject, body, recipients, flag). Use when editing a draft or changing properties on a known message. Obtain id from messages.

outlook_delete_email

Delete an Outlook message by id. Use when the user asks to remove a message. This delete is permanent and cannot be undone; confirm the exact id and get explicit user confirmation before calling. Obtain id from messages.

outlook_send_draft

Send a previously created Outlook draft. Use when a draft is ready to go; the message is saved to Sent Items. Obtain message_id from messages create or messages list (Drafts). For a brand-new send without a draft, use messages send-mail.

outlook_send_email

Send a new Outlook email immediately (subject, body, toRecipients; optional cc/bcc). Use when the user is ready to send without saving a draft first. To save first, use messages create then messages send-draft.

outlook_reply_email

Reply to the sender of an Outlook message. Use when answering one person (not everyone on the thread). Pass message_id and either comment or message.body — not both. For all recipients, use messages reply-all.

outlook_reply_all_email

Reply to all recipients of an Outlook message. Use when the response should go to everyone on the original mail. Pass message_id and an optional comment. For sender-only, use messages reply.

outlook_forward_email

Forward an Outlook message from the connected mailbox to one or more recipients. Use when sharing a message onward. Pass message_id, toRecipients (top-level or on message — not both), and an optional comment. When acting as a different mailbox user, use messages forward-as-user instead.

outlook_forward_email_as_user

Forward an Outlook message from an explicitly selected mailbox (user_id). Use when the connected account can access another user's mailbox and must forward as that user. Pass user_id, message_id, and toRecipients. For the connected user's own mailbox, prefer messages forward.

outlook_move_email

Move an Outlook message to another mail folder. Use when filing mail into a folder (archive, project folder, etc.). Pass message_id and destinationId (folder id or well-known name such as inbox). Obtain folder ids from mail folders.

outlook_list_mail_folders

List top-level Outlook mail folders (Inbox, Drafts, Sent, and user folders). Use when resolving a folder name to an id before listing folder messages or moving mail. For nested folders under a parent, use child folders. Returns one page; pass the response's next_cursor to fetch subsequent pages.

outlook_get_mail_folder

Read one Outlook mail folder: display name and counts. Use when inspecting a known folder id. Obtain id from mail folders.

outlook_create_mail_folder

Create a top-level Outlook mail folder. Use when the user wants a new filing folder. For a folder under an existing parent, use child folders create. Returns the created folder including its id.

outlook_update_mail_folder

Rename or update an Outlook mail folder. Use when changing a folder's display name. Obtain id from mail folders.

outlook_delete_mail_folder

Delete an Outlook mail folder by id. Use when removing a user-created folder. This delete is permanent and cannot be undone; confirm the exact id and get explicit user confirmation before calling. Obtain id from mail folders.

outlook_list_child_folders

List child folders under a parent Outlook mail folder. Use when navigating a nested folder tree. Pass mail_folder_id of the parent from mail folders. For top-level folders, use mail folders instead. Returns one page; pass the response's next_cursor to fetch subsequent pages.

outlook_create_child_folder

Create a child folder under an existing Outlook mail folder. Use when nesting a new folder beneath a parent. For a top-level folder, use mail folders create instead. Returns the created folder including its id.

outlook_get_child_folder

Read one child Outlook mail folder under a parent. Use when inspecting a nested folder by id. Obtain id from child folders.

outlook_delete_child_folder

Delete a child Outlook mail folder by id. Use when removing a nested folder. This delete is permanent and cannot be undone; confirm the exact id and get explicit user confirmation before calling. Obtain id from child folders.

outlook_update_child_folder

Update a child Outlook mail folder (e.g. rename). Use when changing a nested folder. Obtain id from child folders.

outlook_list_folder_emails

List messages inside a specific Outlook mail folder. Use when reading Inbox, Sent, Drafts, or a custom folder by id. Pass mail_folder_id from mail folders (well-known names like inbox may also work). For mailbox-wide search across folders, use messages list instead. Results are summaries; fetch a full record via messages get. Returns one page; pass the response's next_cursor to fetch subsequent pages.