AIMicrosoft 365

Outlook Mail

Send and manage Outlook email from the agent.

Lets the agent find, read, send, move and delete email in Outlook. It requires a Microsoft 365 connection configured in the workspace.

The available operations

When you add this tool, choose which operations the agent is allowed to perform.

Searches the Outlook mailbox by text.

Parameter	Required	Default	What it is
Query	Yes	—	The text to search for (subject, sender, body and so on). It supports filters such as `from:example@email.com`, `subject:report`, `isread:false`
Folder	No	—	The folder to search (`inbox`, `sentitems`, `drafts`). Omitted, it searches all mail
Maximum results	No	`10`	How many messages to return at most

Returns one message's details by its ID.

Parameter	Required	Default	What it is
Email ID	Yes	—	The unique ID of the message
Include the body	No	`true`	With `true`, the full body comes back with it

Sends a message from the connected Outlook account.

Parameter	Required	Default	What it is
Subject	Yes	—	The message's subject
Body	Yes	—	The message's content
Body type	No	`text`	The body's format: `text` (plain) or `html`
Recipients	Yes	—	The main recipients, with an email and optionally a name
CC	No	—	The recipients to copy
BCC	No	—	The recipients to blind-copy
Reply-to	No	—	The addresses replies should go to
Importance	No	`normal`	The message's importance: `low`, `normal` or `high`
Save to Sent Items	No	`true`	With `true`, the sent message is saved to Sent Items

Moves a message to a different folder.

Parameter	Required	Default	What it is
Email ID	Yes	—	The unique ID of the message to move
Destination folder ID	Yes	—	The destination folder's ID or name (`inbox`, `drafts`, `sentitems`, `deleteditems`, `junkemail`)

Removes a message from the mailbox.

Parameter	Required	Default	What it is
Email ID	Yes	—	The unique ID of the message to remove

caution

This deletes the message permanently, with no way to recover it. To move it to the bin instead, use Move an email with the deleteditems folder.