Outlook Calendar
How Dispatch reads availability and creates, updates, and cancels events on your Outlook (Microsoft 365) calendar.
To connect Outlook Calendar, open the in-app Connections settings.
Outlook Calendar is one of two calendar backends Dispatch supports (the other is Google Calendar). The agent reads free/busy directly from Microsoft Graph and creates events that show up on your real calendar.
OAuth scopes
Dispatch requests the Microsoft Graph calendar scopes it needs and no more. The in-app connect screen shows the current scope request before you authorize.
Read capabilities
- List events on any connected calendar within a date range.
- Search events by attendee, title, or text.
- Free/busy queries across one or more calendars.
- Read attendee responses and event metadata (location, online-meeting data, attachment metadata).
Write capabilities
All writes carry the external-write risk annotation and pass through the permission gate.
- Create events (with attendees, online meetings, reminders, time zone).
- Update events (time, attendees, location, body).
- Cancel events.
Responding to invitations (accept, decline, tentative) is not currently exposed by the Outlook Calendar connector. Update or cancel an event directly to communicate scheduling changes.
What automations can use
Three event-driven triggers fire off the calendar:
- Event Added (
OUTLOOK_EVENT_ADDED). A new meeting was added to the user's calendar. - Meeting Prep (
OUTLOOK_MEETING_PREP). Fires shortly before a scheduled meeting so the agent can brief. - Transcript Received (
OUTLOOK_TRANSCRIPT_RECEIVED). Fires when a meeting transcript becomes available, including transcripts produced by the meeting notetaker.
Scheduled actions can also read or modify the calendar on a cron-like cadence. Triggers on event changes are not currently exposed.
Limits and behavior
- Multiple calendars per account. The agent can read and write across all calendars on a connected account.
- Multi-account. A user can connect multiple Microsoft accounts; the agent picks the right one when explicit, asks otherwise.
- Online meetings. When creating events the agent can attach a Microsoft Teams meeting link.
- No automatic time-zone inference. The agent uses the calendar's configured time zone by default; explicit time-zone language in your request overrides.
Related
- Meetings: the user-facing surface that uses Outlook Calendar.
- Booking links: booking flows that read availability and write events.
- Permission gate
- Cookbook: Morning briefing