Skip to main content

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 invoice from 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.

  1. Go to Organization > Connectors and find Outlook. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Microsoft Entra admin center.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. 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.Read
  • Calendars.Read.Shared
  • Calendars.ReadBasic
  • Calendars.ReadWrite
  • Contacts.Read
  • Contacts.ReadWrite
  • Mail.Read
  • Mail.ReadWrite
  • Mail.Send
  • User.Read
  • User.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.

ToolWhat it does
find_contacts_by_companyFind contacts by company across folder pages.
find_contacts_by_emailFind contacts by email address with pagination support.
find_meeting_timesFind optimal meeting times based on attendee availability, suggesting times that work for required participants
get_child_foldersGet 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_contactGet a specific contact by ID.
get_contactsRetrieve contacts from a folder with pagination support. top max 100.
get_eventGet a specific calendar event by ID.
get_eventsRetrieve calendar events within a time range with pagination support.
get_folder_message_countGet message counts for a folder
get_mail_folderGet a specific mail folder by ID.
get_mail_foldersGet all mail folders with pagination support. filter_query (OData $filter, e.g. "displayName eq 'Archive'") and select_fields narrow the result.
get_messageGet a specific message by ID, including its body.
get_message_attachmentGet a specific attachment from an email message by ID.
get_message_attachments_metadataGet metadata for all attachments in an email message without downloading content.
get_messagesList messages in a mail folder.
get_past_eventsGet past calendar events from previous days.
get_today_eventsGet today's calendar events.
get_unread_messagesGet unread messages from a folder with pagination support.
get_upcoming_eventsGet upcoming calendar events.
get_user_by_emailGet detailed user information by email address (userPrincipalName)
get_user_scheduleGet free/busy schedule information for users, distribution lists, or resources for a specified time period
get_well_known_folderGet a well-known folder by name
list_calendarsList the user's calendars (including shared ones).
list_contact_foldersList the user's contact folders (subfolders of the default Contacts folder) with their id and displayName.
list_message_attachmentsList attachments for an email message with pagination support.
list_usersList users in the organization with pagination support, filtering, ordering. search_query: a bare search term (e.g. budget).
search_contactsSearch contacts across folder pages.
search_eventsSearch for calendar events with pagination support.
search_messagesSearch for messages with pagination support.
search_usersSearch for users by name, email with pagination support and full-text search
validate_credentialValidate Microsoft Graph API credentials by attempting to fetch the authenticated user's profile

Write (11)​

Create or send data.

ToolWhat it does
copy_mail_folderCopy a mail folder
create_contactCreate a new contact.
create_draft_messageCreate a draft message.
create_eventCreate a calendar event (one-time or recurring).
create_forward_draftCreate a forward draft of an email without sending it; Graph copies the original body and attachments.
create_mail_folderCreate a new mail folder
create_meetingCreate a meeting with attendees (one-time or recurring)
create_teams_meetingCreate a Teams meeting with enhanced online meeting support
forward_messageForward an email to new recipients and send it immediately; Graph includes the original body and attachments and keeps the conversation thread.
reply_to_messageReply in the original thread and send now.
send_messageCompose and send an email in one call.

Delete or overwrite (16)​

Remove or replace existing data.

ToolWhat it does
accept_eventAccept a meeting invitation on the user's calendar (attendee action).
cancel_eventCancel a meeting you organize and send a cancellation notice (with optional comment) to all attendees; the event moves to Deleted Items.
decline_eventDecline a meeting invitation on the user's calendar (attendee action).
delete_contactDelete a contact.
delete_eventDelete a calendar event.
delete_mail_folderDelete a mail folder.
delete_messageDelete a message.
mark_message_as_readMark a message as read
mark_message_as_unreadMark a message as unread
move_mail_folderMove a mail folder
move_messageMove a message to another mail folder by folder ID.
send_draftSend an existing draft by ID: pass the 'id' from create_draft_message, or find saved drafts with get_messages(folder_id='drafts').
update_contactUpdate a contact.
update_eventUpdate a calendar event.
update_mail_folderUpdate a mail folder.
update_messageUpdate a message.
⌘J