Microsoft Outlook
Microsoft Outlook integration for email, calendar, contacts, and folder management via Microsoft Graph
The Microsoft Outlook integration lets your agents read and send email, manage calendar events, work with contacts, and organize mail folders in a connected Microsoft 365 account through the Microsoft Graph API.
Prerequisites
- A Microsoft 365 account (work, school, or personal) with the mailbox you want the agent to access.
- Permission to authorize third-party apps in your tenant. Some organizations require admin consent for the requested scopes.
Setup
-
Open Integrations from the sidebar
-
Select Microsoft Outlook from the catalog
-
Click Add Integration Config
-
Give the config a display name (e.g., "Outlook — Support inbox").
-
Click Connect and complete the Microsoft sign-in.
-
In the OAuth scope picker, choose which Graph permissions to grant. Each scope is requested independently:
Scope Required for Recommended Read user profile ( User.Read)Identifying the connected mailbox Yes Read mail ( Mail.Read)Reading messages, listing folders, search Yes Send mail ( Mail.Send)Sending, replying, forwarding If the agent sends Modify mail ( Mail.ReadWrite)Creating folders, moving/deleting messages, marking read/unread If the agent manages mail Read calendar ( Calendars.Read)Listing and reading events (read-only) If the agent only reads calendar Manage calendar ( Calendars.ReadWrite)Creating, updating, and deleting events If the agent writes to calendar Read contacts ( Contacts.Read)Listing and searching contacts (read-only) If the agent only reads contacts Manage contacts ( Contacts.ReadWrite)Creating and modifying contacts If the agent writes contacts Stay connected ( offline_access)Background refresh so users aren't reprompted Yes Read-only tools accept either the read or the read/write scope — e.g.
list_eventsworks withCalendars.ReadorCalendars.ReadWrite— so you can grant the narrower scope when the agent never writes. -
Grant only what the agent actually needs — the OAuth picker lets you uncheck scopes you don't want exposed.
-
Save the config
Connection testing is available — click Test on the saved config to verify the credentials and granted scopes against Microsoft Graph before deploying.
Using in Your Agent
- Open your agent in Agent Studio and select an Agent Step
- Under Attached Integration Configurations, click Attach configuration and choose your config
- Attach Outlook tools from the tools panel
- Tools are referenced as
outlook.list_messages,outlook.send_email,outlook.create_event, etc.
A tool will only execute successfully if the OAuth scope it requires was granted during setup. If you later attach a tool that needs a scope you didn't grant (say, send_email without Mail.Send), reauthorize the config and add the missing scope.
Sandbox routing
Outlook ships with sandbox classifications so destructive or send-style tools can be routed to a simulator during evaluation runs and dry runs. See Sandbox Mode for how routing is resolved at the tenant credential level.
Available Tools
| Tool | Description | Action Type |
|---|---|---|
list_messages | List recent email messages | ReadOnly |
get_message | Retrieve a single message by ID, with the body returned as plain text | ReadOnly |
search_emails | Keyword search across subject, body, and sender | ReadOnly |
send_email | Send a new email with HTML body and comma-separated To/CC/BCC recipients | Irreversible |
reply_to_message | Reply to an existing message | Irreversible |
forward_message | Forward an existing message to comma-separated recipients, with an optional comment | Irreversible |
mark_message_read | Mark a message as read or unread | Reversible |
move_message | Move a message to another mail folder | Reversible |
delete_message | Delete a message (moves it to Deleted Items) | Irreversible |
list_attachments | List attachment metadata (IDs, names, sizes) on a message | ReadOnly |
import_attachments | Download a message's attachments into the Fruxon session | ReadOnly |
Calendar
| Tool | Description | Action Type |
|---|---|---|
list_events | List events within a date/time range | ReadOnly |
get_event | Retrieve a single event with full details | ReadOnly |
create_event | Create a new event with comma-separated required/optional attendees, location, body | Reversible |
update_event | Update fields on an existing event | Reversible |
delete_event | Delete an event by ID | Irreversible |
Contacts
| Tool | Description | Action Type |
|---|---|---|
list_contacts | List contacts from the user's address book | ReadOnly |
search_contacts | Search contacts by name, email, or company | ReadOnly |
create_contact | Create a new contact entry | Reversible |
Mail folders
| Tool | Description | Action Type |
|---|---|---|
list_folders | List mail folders (Inbox, Sent Items, Drafts, custom folders) | ReadOnly |
create_folder | Create a new mail folder | Reversible |