Microsoft Outlook Calendar
Service domainCALENDAR
Arcade Optimized
Arcade.dev LLM tools for Outlook Calendar
8tools
Microsoft Outlook Calendar Toolkit
The Microsoft Outlook Calendar toolkit lets agents and LLM-powered apps read, search, and manage Outlook Calendar data for authenticated Microsoft 365 users via the Microsoft Graph API.
Capabilities
- Event management — Create events in the user's default calendar, retrieve a single event by ID, and list events within a specific time range.
- Search and discovery — Search calendar events across a time range with optional filters; results are chronologically ordered with truncated bodies for efficient skimming, and full details are retrievable by event ID.
- Scheduling and availability — Fetch free/busy schedules for one or more people over a time range, including per-interval availability views, detailed schedule blocks with absolute start/end times, and working-hours data where available.
- Calendar and attachment metadata — List all calendars the user has access to (own, shared, and delegated), and retrieve attachment metadata (name, size, type) for specific calendar events.
- Identity context — Retrieve information about the authenticated user and their Outlook Calendar environment.
OAuth
This toolkit authenticates via OAuth 2.0 using Microsoft as the provider. Arcade manages the OAuth flow automatically.
See the 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. |
Get Building
Last updated on