Microsoft Outlook Calendar
Service domainCALENDAR
Arcade Optimized
Arcade.dev LLM tools for Outlook Calendar
8tools
The Microsoft Outlook Calendar toolkit connects Arcade-powered LLMs to a user's Outlook Calendar via the Microsoft Graph API. It enables agents to read, search, create, and inspect calendar data on behalf of authenticated users.
Capabilities
- Event management: Create events in the user's default calendar and retrieve individual events by ID.
- Calendar discovery: List all calendars a user has access to, including shared and delegated calendars, with IDs usable across other tools.
- Event search and listing: List events in a time range or search with optional filters; results are chronological and bodies are truncated for skimming, with full details retrievable via event ID.
- Free/busy scheduling: Retrieve availability for one or more people over a time range, including per-interval availability views, detailed schedule blocks, and working-hours data — with explicit handling of unresolvable calendars and timezone fallback caveats.
- Attachment inspection: List attachment metadata (name, size, type) for a calendar event; supports shared and delegated calendars via
calendar_id. - User/environment introspection: Retrieve the current user's identity and mailbox timezone, including the source of that timezone setting, to inform correct time handling by the agent.
OAuth
This toolkit uses OAuth 2.0 via Microsoft as the identity provider. See the Arcade Microsoft auth provider docs for configuration details.
Available tools(8)
8 of 8 tools
Operations
Behavior
| Tool name | Description | Secrets | |
|---|---|---|---|
Create an event in the authenticated user's default calendar.
Ignores timezone offsets provided in the start_date_time and end_date_time parameters.
Instead, uses the user's default calendar timezone to filter events.
If the user has not set a timezone for their calendar, then the timezone will be UTC. | |||
Get an event by its ID from the user's calendar. | |||
Get the free/busy availability of one or more people over a time range.
Timezone offsets in start_date_time and end_date_time are ignored. The window is anchored
in the returned time_zone, which is the authenticated user's mailbox timezone, and may be a
Windows name such as "Eastern Standard Time" rather than an IANA identifier - that names a
zone observing daylight saving, not a fixed offset. time_zone_source is "mailbox" only when
the user's mailbox named that zone; it is "fallback" whenever the window is anchored to UTC,
which cannot be distinguished from a mailbox that names no zone at all. On "fallback" treat
every time in the response as unconfirmed and check the intended zone before acting.
Each person's availability_view has one digit per interval, beginning at start_date_time in
that time_zone: 0 = free (or working elsewhere), 1 = tentative, 2 = busy, 3 = out of
office. For the specific times a person is busy, prefer schedule_items, which lists each
block with absolute start and end times; each item's status is one of free, tentative,
busy, oof, workingElsewhere, or unknown.
When Graph provides it, working_hours gives the days and hours a person works. These are on
that person's own clock - named by working_hours.time_zone when Graph resolves it - and are
not converted to the window's time_zone, so do not compare them directly against
availability_view without accounting for the difference.
Results cover only each person's primary calendar. Events that live solely on a secondary
calendar do not mark them busy, so free/busy can read clear while such an event exists.
Visibility depends on your access to each person's calendar. Colleagues, rooms, and
resources whose free/busy is shared with you return busy/free times; an event's subject,
location, and is_private flag appear only when its details are shared with you. A calendar
you cannot see is returned all-free with no error, which is indistinguishable from
genuinely free, so every all-free result carries a "note" marking it unconfirmed. An
address Graph could not resolve or read carries an "error" instead, and is still listed so
that no requested address is silently dropped. One address failing does not affect the rest,
and an error naming too many calendar entries is worth retrying for that address alone over
a shorter range. | |||
List all calendars the user has access to.
Returns the user's own calendars plus any shared or delegated calendars.
Each calendar includes its ID, name, owner, and permissions.
Use a calendar_id from the results to target a specific calendar
in other calendar tools. | |||
List attachment metadata for a calendar event.
Returns metadata only (name, size, type, etc.). Attachment content is not included.
Use this tool when the user wants to know what files are attached to a calendar event
or meeting.
Pass a calendar_id to list attachments on events in shared or delegated calendars. | |||
List events in the user's calendar in a specific time range.
Ignores timezone offsets provided in the start_date_time and end_date_time parameters.
Instead, uses the user's default calendar timezone to filter events.
If the user has not set a timezone for their calendar, then the timezone will be UTC. | |||
Search calendar events within a time range with optional filters.
Results are in chronological order.
Event bodies are truncated to 200 characters for efficient skimming.
Use the event_id from the results to retrieve full event details. | |||
Get information about the current user and their Outlook Calendar environment.
mailbox_timezone is the time zone this mailbox's dates are expressed in. It may be a
Windows name such as "Eastern Standard Time" rather than an IANA identifier - that
names a zone observing daylight saving, not a fixed offset. mailbox_timezone_source
says where it came from: "mailbox" and "mailbox_utc" mean the mailbox itself names
the zone, whereas "default_not_configured" (the mailbox names none) and
"default_unreadable" (the setting could not be read) mean UTC is a fallback this
toolkit applied, not a zone the mailbox is set to. On either fallback, do not tell
the user their mailbox is configured for that zone. |
Get Building
Last updated on