Skip to main content

At a glance

  • Availability: Enabled by default.
  • Auth: OAuth 2.0.
  • Connection: A user authorizes the connection in the provider’s consent screen.
  • Scopes: Mail.Read, Mail.Send, Mail.ReadWrite, Calendars.Read, Calendars.ReadWrite, Group.Read.All, Group-Conversation.Read.All, offline_access.

Credentials

Set these per environment. See Connect an integration. With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.
VariableRequiredDescription
MICROSOFT_CLIENT_IDYesMicrosoft Azure App Client ID (Application ID) Docs.
MICROSOFT_CLIENT_SECRETYesMicrosoft Azure App Client Secret Docs.

Tools

ToolAccessDescription
List EmailsReadList recent emails from inbox or a specific folder
Get EmailReadGet detailed information about a specific email
Send EmailWriteSend a new email message
Search EmailsReadSearch emails by query, subject, sender, or date
List FoldersReadList all mail folders in the mailbox
Get FolderReadGet metadata for a mail folder
Create FolderWriteCreate a mail folder
Update FolderWriteRename a mail folder
Delete FolderWriteDelete a mail folder
Mark Email ReadWriteMark an email as read
Mark Email UnreadWriteMark an email as unread
Delete EmailWriteDelete an email message
Move EmailWriteMove an email to another folder
Archive EmailWriteMove an email to the archive folder
Flag EmailWriteSet a follow-up flag on an email
Clear Email FlagWriteClear the follow-up flag on an email
Categorize EmailWriteReplace the categories on an email
List CategoriesReadList Outlook master categories
Create CategoryWriteCreate an Outlook master category
Update CategoryWriteUpdate an Outlook master category color
Delete CategoryWriteDelete an Outlook master category
Create DraftWriteCreate a draft email message
List DraftsReadList draft email messages
Get DraftReadGet a draft message
Update DraftWriteUpdate a draft email message
Send DraftWriteSend a draft email message
Delete DraftWriteDelete a draft email message
Reply EmailWriteReply to an email
Reply All EmailWriteReply all to an email
Forward EmailWriteForward an email
Create Reply DraftWriteCreate a reply draft for an email
Create Reply All DraftWriteCreate a reply-all draft for an email
Create Forward DraftWriteCreate a forward draft for an email
List AttachmentsReadList attachments for an email message
Get AttachmentReadGet metadata and content for an email attachment
Add Attachment To MessageWriteAdd a small attachment to a draft message
List Conversation MessagesReadList messages in an Outlook conversation
List Shared Mailbox EmailsReadList messages from a shared or delegated mailbox that the signed-in Microsoft account can access
Search Shared Mailbox EmailsReadSearch messages in a shared or delegated mailbox that the signed-in Microsoft account can access
Find Group By MailReadFind a Microsoft 365 group by primary email address before reading its group inbox threads
List Group ThreadsReadList Microsoft 365 group inbox conversation threads
List Group Thread PostsReadList posts from a Microsoft 365 group inbox conversation thread
List CalendarsReadList Outlook calendars
Get CalendarReadGet metadata for an Outlook calendar
Create CalendarWriteCreate an Outlook calendar
Update CalendarWriteUpdate an Outlook calendar
Delete CalendarWriteDelete an Outlook calendar
List EventsReadList events from a specific Outlook calendar
List Calendar ViewReadList occurrences in a calendar time window
Get EventReadGet details for an Outlook event
Create EventWriteCreate an Outlook calendar event
Update EventWriteUpdate an Outlook calendar event
Delete EventWriteDelete an Outlook calendar event
Respond To EventWriteAccept, tentatively accept, or decline an event invitation
Get Event InstancesReadList instances of a recurring event in a time window
List Event AttachmentsReadList attachments for an event
Get Event AttachmentReadGet metadata and content for an event attachment
Add Event AttachmentWriteAdd a small attachment to an event
Find Free TimeReadReturn free/busy schedule information for users or resources
Get ScheduleReadGet detailed free/busy schedule information
Find Meeting TimesReadFind meeting time suggestions from attendees and constraints

Example prompts

  • List my recent unread emails and summarize the most important ones.
  • Search my emails for specific topics, senders, or date ranges.
  • Help me draft a professional email with proper formatting and tone.