Microsoft Outlook Calendar
Service domainCALENDAR
Arcade Optimized
Arcade.dev LLM tools for Outlook Calendar
8tools
Microsoft Outlook Calendar Toolkit
The Microsoft Outlook Calendar toolkit gives Arcade-powered agents and LLMs the ability to read, search, create, and inspect calendar events and schedules via the Microsoft Graph API.
Capabilities
- Calendar discovery & context: List all calendars the authenticated user can access (own, shared, delegated) and retrieve current user/environment metadata.
- Event lifecycle: Create events in the user's default calendar and fetch individual events by ID, with awareness that timezone offsets in datetime parameters are ignored in favor of the mailbox or calendar timezone.
- Event search & listing: Query events across a time range with chronological ordering; search with optional filters and truncated bodies for efficient scanning; retrieve full event details via ID.
- Free/busy scheduling: Retrieve availability for one or more people over a time range, with per-interval status codes and explicit handling of unresolved addresses, permission-limited calendars, and timezone source ambiguity (mailbox vs. UTC fallback).
- Attachment inspection: List attachment metadata (name, size, type) for calendar events, including on shared or delegated calendars; content retrieval is not included.
OAuth
This toolkit authenticates via OAuth 2.0 using Microsoft as the identity provider. See the Arcade Microsoft auth provider docs for setup details, required app registration steps, and supported scopes.
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. |
Get Building
Last updated on