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 your agent in Agent Studio.
-
In the Integrations panel, click Add Integration Config.
-
Select Microsoft Outlook from the integration list.
-
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 mail folders, moving messages If the agent manages mail Manage calendar ( Calendars.ReadWrite)Reading and modifying calendar events If the agent uses calendar tools Manage contacts ( Contacts.ReadWrite)Reading and modifying contacts If the agent uses contact tools Stay connected ( offline_access)Background refresh so users aren't reprompted Yes -
Grant only what the agent actually needs — the OAuth picker lets you uncheck scopes you don't want exposed.
-
Save the agent revision.
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
- In an Agent Step, 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, optionally scoped to a folder | ReadOnly |
get_message | Retrieve a single message by ID, including full body | ReadOnly |
search_emails | Keyword search across subject, body, and sender | ReadOnly |
send_email | Send a new email with HTML body, To/CC recipients | Irreversible |
reply_to_message | Reply to an existing message | Irreversible |
forward_message | Forward an existing message to new recipients | Irreversible |
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 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 |