Outlook
Comprehensive Microsoft Outlook connector for managing email operations, calendar events, contacts, and mailbox organization through Microsoft Graph API.
What you can ask
- Find every email from contacts at our top-10 accounts in the last 7 days I haven't replied to.
- Draft a follow-up reply to the latest message from
customer@acme.com. - Search for emails with
invoicefrom this month and forward to accounting\@.
Set up
Outlook needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find Outlook. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Microsoft Entra admin center.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- Each member connects their own account the first time they use it.
⚠️ Warning: Do not enter your Devs.ai or Outlook login email or password in the OAuth application fields.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
OAuth scopes used by these tools (11)
Grant the scopes for the tools you plan to allow.
Calendars.ReadCalendars.Read.SharedCalendars.ReadBasicCalendars.ReadWriteContacts.ReadContacts.ReadWriteMail.ReadMail.ReadWriteMail.SendUser.ReadUser.ReadBasic.All
Tools
Outlook offers 58 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (31)
View and search information without changing it.
| Tool | What it does |
|---|---|
find_contacts_by_company | Find contacts by company across folder pages. |
find_contacts_by_email | Find contacts by email address with pagination support. |
find_meeting_times | Find optimal meeting times based on attendee availability, suggesting times that work for required participants |
get_child_folders | Get child folders of a parent folder with pagination support. filter_query (OData $filter, e.g. "displayName eq 'Archive'") and select_fields narrow the result. |
get_contact | Get a specific contact by ID. |
get_contacts | Retrieve contacts from a folder with pagination support. top max 100. |
get_event | Get a specific calendar event by ID. |
get_events | Retrieve calendar events within a time range with pagination support. |
get_folder_message_count | Get message counts for a folder |
get_mail_folder | Get a specific mail folder by ID. |
get_mail_folders | Get all mail folders with pagination support. filter_query (OData $filter, e.g. "displayName eq 'Archive'") and select_fields narrow the result. |
get_message | Get a specific message by ID, including its body. |
get_message_attachment | Get a specific attachment from an email message by ID. |
get_message_attachments_metadata | Get metadata for all attachments in an email message without downloading content. |
get_messages | List messages in a mail folder. |
get_past_events | Get past calendar events from previous days. |
get_today_events | Get today's calendar events. |
get_unread_messages | Get unread messages from a folder with pagination support. |
get_upcoming_events | Get upcoming calendar events. |
get_user_by_email | Get detailed user information by email address (userPrincipalName) |
get_user_schedule | Get free/busy schedule information for users, distribution lists, or resources for a specified time period |
get_well_known_folder | Get a well-known folder by name |
list_calendars | List the user's calendars (including shared ones). |
list_contact_folders | List the user's contact folders (subfolders of the default Contacts folder) with their id and displayName. |
list_message_attachments | List attachments for an email message with pagination support. |
list_users | List users in the organization with pagination support, filtering, ordering. search_query: a bare search term (e.g. budget). |
search_contacts | Search contacts across folder pages. |
search_events | Search for calendar events with pagination support. |
search_messages | Search for messages with pagination support. |
search_users | Search for users by name, email with pagination support and full-text search |
validate_credential | Validate Microsoft Graph API credentials by attempting to fetch the authenticated user's profile |
Write (11)
Create or send data.
| Tool | What it does |
|---|---|
copy_mail_folder | Copy a mail folder |
create_contact | Create a new contact. |
create_draft_message | Create a draft message. |
create_event | Create a calendar event (one-time or recurring). |
create_forward_draft | Create a forward draft of an email without sending it; Graph copies the original body and attachments. |
create_mail_folder | Create a new mail folder |
create_meeting | Create a meeting with attendees (one-time or recurring) |
create_teams_meeting | Create a Teams meeting with enhanced online meeting support |
forward_message | Forward an email to new recipients and send it immediately; Graph includes the original body and attachments and keeps the conversation thread. |
reply_to_message | Reply in the original thread and send now. |
send_message | Compose and send an email in one call. |
Delete or overwrite (16)
Remove or replace existing data.
| Tool | What it does |
|---|---|
accept_event | Accept a meeting invitation on the user's calendar (attendee action). |
cancel_event | Cancel a meeting you organize and send a cancellation notice (with optional comment) to all attendees; the event moves to Deleted Items. |
decline_event | Decline a meeting invitation on the user's calendar (attendee action). |
delete_contact | Delete a contact. |
delete_event | Delete a calendar event. |
delete_mail_folder | Delete a mail folder. |
delete_message | Delete a message. |
mark_message_as_read | Mark a message as read |
mark_message_as_unread | Mark a message as unread |
move_mail_folder | Move a mail folder |
move_message | Move a message to another mail folder by folder ID. |
send_draft | Send an existing draft by ID: pass the 'id' from create_draft_message, or find saved drafts with get_messages(folder_id='drafts'). |
update_contact | Update a contact. |
update_event | Update a calendar event. |
update_mail_folder | Update a mail folder. |
update_message | Update a message. |