Outlook Email
Use Outlook Email to search a connected mailbox, inspect messages, save a draft, send a reviewed email, and organize selected messages.
Before you start
Section titled “Before you start”Open Customize → Plugins and select this plugin. Add installs an available package; Uninstall means it is already installed. An offered Update refreshes its package version. Your deployment and administrator policy determine availability.
When Add Account is offered, follow its connection instructions using an authorized account that owns or can access the intended resource. If several accounts are connected, check the selected account and Default before the task. Reconnect refreshes an expired connection; an administrator setup notice needs administrator configuration.
Enable the plugin for the selected agent or task. On an installed plugin’s Tools table, check Enabled and the Approval setting for the operations you intend to use. New tasks use these settings; a pending approval still needs a decision. See agent setup and action approvals.

Plugin details under Customize → Plugins. The button shows the current installation state.
Prepare a project email
Section titled “Prepare a project email”- Ask Redbelt to list mailbox folders and search for a project discussion using a topic you provide.
- Read the relevant message IDs. A batch read can inspect up to 20 selected messages at a time.
- Draft a milestone update using the deadlines stated in the messages and a request for owner confirmation.
- Check recipients, subject, and content before creating the Outlook draft.
- Review the saved draft. Sending is a separate action: specify the final recipients and request it explicitly.
- Inspect the returned result and locate the message in the mailbox.
Search my connected Outlook mailbox for the project topic I provide. Read the relevant messages and prepare a draft summarizing agreed milestones and asking the team to confirm missing owners. Use only dates stated in the messages. Do not send it yet.
Organize selected messages
Section titled “Organize selected messages”Mailbox-wide listing, folder listing, listing messages inside a folder, and search have different scopes. Follow returned paging when you need a complete result set. A read retrieves a chosen message rather than searching for its title again.
Moving a message needs both its message ID and destination folder ID. Confirm that destination through folder discovery. Deleting is a separate operation and should target only the messages you selected. Check the returned result and provider folder rather than assuming a requested change succeeded.
Draft creation and sending are separate tools. A saved draft or accepted API request does not establish that the recipient received the message.
Tool Reference
Section titled “Tool Reference”Thread and workflow availability are listed separately. A tool must also be enabled for your task and allowed by its account and administrator policy. Configure workflow app actions using only actions offered by the current picker.
Available Tools
Section titled “Available Tools”| Tool | Required Fields | Thread | Workflow |
|---|---|---|---|
microsoft_mail.create_draft |
to_recipients, subject, content |
Yes | Yes |
microsoft_mail.delete_message |
message_id |
Yes | No |
microsoft_mail.get_message |
message_id |
Yes | No |
microsoft_mail.list_folder_messages |
mail_folder_id |
Yes | No |
microsoft_mail.list_folders |
No mandatory top-level fields | Yes | No |
microsoft_mail.list_messages |
No mandatory top-level fields | Yes | Yes |
microsoft_mail.move_message |
message_id, destination_id |
Yes | No |
microsoft_mail.read_message_batch |
message_ids |
Yes | No |
microsoft_mail.search |
query_text |
Yes | Yes |
microsoft_mail.send |
to_recipients, subject, content |
Yes | Yes |
Required fields above are the schema minimum. The target, selected operation, or account can impose additional requirements.
microsoft_mail.create_draft — Create a draft email in Outlook.
Optional fields: attachment_paths, attachment_upload_ids, bcc_recipients, cc_recipients, content_type.
microsoft_mail.delete_message — Delete an email message.
microsoft_mail.get_message — Get a specific email message by ID.
Optional fields: select.
microsoft_mail.list_folder_messages — List messages in a specific mail folder.
Optional fields: filter, orderby, search, select, top.
microsoft_mail.list_folders — List mail folders in the user’s mailbox.
Optional fields: include_hidden.
microsoft_mail.list_messages — List messages in the signed-in user’s mailbox with optional search and filtering.
Optional fields: is_read, query_text, relative_date_range, top.
microsoft_mail.move_message — Move a message to a different folder.
microsoft_mail.read_message_batch — Read full Outlook email content for up to 20 exact message IDs per call.
microsoft_mail.search — Search across Outlook emails.
Optional fields: from_index, has_attachment, is_read, relative_date_range, sender, size, subject, to.
microsoft_mail.send — Send a new email via Outlook.
Optional fields: attachment_paths, attachment_upload_ids, bcc_recipients, cc_recipients, content_type, save_to_sent_items.
Troubleshoot
Section titled “Troubleshoot”Check the connected Microsoft account and mailbox if folders or messages are missing. For an interrupted send, inspect the sent items before retrying.
Provider details: Outlook documentation.