SecureAuth AI Gateway
IntegrationsResources

Microsoft 365

Mail, Calendar, Teams, SharePoint, OneDrive, and Word via Microsoft's Work IQ MCP servers

Microsoft 365 integration connects your agents to Mail, Calendar, Teams, SharePoint, OneDrive, and Word through Microsoft's Work IQ MCP servers. A single catalog resource covers all six surfaces, and each user's account is automatically scoped to their own Microsoft tenant.

Setup

  1. Navigate to Resources and click Add Resource
  2. Select Microsoft 365 from the catalog
  3. Choose a credential mode (see below)
  4. Click Add

The resource is added with all tools and scopes pre-configured. Each user connects their own Microsoft 365 account via OAuth when they first use a Microsoft 365 tool. Navigate to Connections to manage linked accounts.

Supported credential modes

Microsoft 365 supports two modes:

  • Use SecureAuth's app — install instantly with SecureAuth's pre-registered multi-tenant Entra application. No setup on your side. Recommended for most installs.
  • Bring your own app — use an Entra app registration owned by your tenant. Recommended for organizations that require admin-consented apps under their own tenant for compliance, conditional access, or auditing.

See Credential modes for the full comparison.

Available tools

Mail — search & read

ToolDescription
SearchMessagesNatural-language mailbox search via Microsoft 365 Copilot
SearchMessagesQueryParametersSearch the mailbox using OData query parameters passed to Microsoft Graph
GetMessageGet a message by ID

Mail — drafts & sending

ToolDescription
CreateDraftMessageCreate a draft email without sending it
UpdateDraftUpdate a draft's recipients, subject, body, sensitivity, and attachments
AddDraftAttachmentsAdd attachments (URIs) to an existing draft
SendDraftMessageSend an existing draft message by ID
SendEmailWithAttachmentsCreate and send an email with optional attachments (URIs or base64-encoded files)

Mail — reply & forward

ToolDescription
ReplyToMessageReply to a message — drafts by default, or sends immediately when sendImmediately=true
ReplyAllToMessageReply all to a message — drafts by default, or sends immediately
ReplyWithFullThreadReply preserving the full quoted thread, optionally re-attaching original files
ReplyAllWithFullThreadReply all preserving the full quoted thread, optionally re-attaching original files
ForwardMessageForward a message, optionally adding comment, recipients, and new attachments
ForwardMessageWithFullThreadForward preserving the full quoted thread, optionally re-attaching original files

Mail — manage

ToolDescription
UpdateMessageUpdate a message's mutable properties (subject, body, categories, importance, sensitivity)
FlagEmailUpdate the flag status on a message
DeleteMessageDelete a message

Mail — attachments

ToolDescription
GetAttachmentsGet attachment metadata (ID, name, size, type) for a message
DownloadAttachmentDownload attachment content as a base64-encoded string
UploadAttachmentUpload a small file attachment (<3 MB, base64-encoded) to a message
UploadLargeAttachmentUpload a large file attachment (3–150 MB, base64-encoded) via chunked upload
DeleteAttachmentDelete an attachment from a message

Calendar — events

ToolDescription
ListEventsList a user's calendar events (master series only for recurring meetings)
ListCalendarViewList events from a calendar view with recurring events expanded into individual instances
CreateEventCreate a calendar event (Teams meeting included by default; supports recurrence and all-day)
UpdateEventUpdate a calendar event (preserves the Teams meeting section when editing online meetings)
DeleteEventByIdDelete a calendar event by ID without sending cancellation notices
CancelEventCancel an event as the organizer, sending cancellation to attendees

Calendar — invitations

ToolDescription
AcceptEventAccept a calendar event invitation
DeclineEventDecline a calendar event invitation
TentativelyAcceptEventTentatively accept a calendar event invitation
ForwardEventForward a calendar event to other recipients

Calendar — scheduling

ToolDescription
FindMeetingTimesSuggest meeting times that work for all attendees based on availability
GetRoomsList the meeting rooms defined in the user's tenant

User

ToolDescription
GetUserDateAndTimeZoneSettingsGet a user's date/timezone, working hours, and language settings

Required scopes

  • openid, profile — sign-in identity
  • offline_access — maintain access when the user is offline
  • User.Read — read the signed-in user's profile
  • Mail.ReadWrite — read, create, update, and delete mail
  • Mail.Send — send mail as the signed-in user
  • Calendars.ReadWrite — read and write calendar events
  • Chat.ReadWrite — read and write Teams chat messages
  • ChannelMessage.Read.All — read Teams channel messages
  • ChannelMessage.Send — send Teams channel messages
  • Files.ReadWrite.All — read and write OneDrive and SharePoint files
  • Sites.ReadWrite.All — read and write SharePoint site content

Policy examples

  • Allow read-only access: tool patterns Search*, Get*, List*, Download*, Find*
  • Block sending and replies: deny rules for Send*, Reply*, Forward* above any allow rules
  • Block destructive operations: deny rules for Delete*, Cancel*, Update*
  • Allow mail triage but block calendar changes: allow *Message*, Get*, Search*, then deny *Event* (still permits read via ListEvents if you allow it explicitly above the deny)
  • Allow full access for a specific agent: scope an allow rule for * to that agent on this MCP server

On this page