IntegrationsProductivity & DocsMicrosoftOutlook Calendar

Outlook Calendar

Description: Enable agents to create and list events in Outlook Calendar.

Author: Arcade

Code: GitHub

Auth: User authorization via the Microsoft auth provider

PyPI VersionLicensePython VersionsWheel StatusDownloads

The Arcade Outlook Calendar toolkit provides pre-built tools for working with calendar events using the Outlook API. Use these tools to:

  • Create events
  • List events
  • Get an event

Available Tools

These tools are currently available in the Arcade Sheets toolkit.

Tool NameDescription
CreateEventCreate an event in the authenticated user's default calendar
GetEventGet an event by its ID from the user's calendar
ListEventsInTimeRangeist events in the user's calendar in a specific time range

If you need to perform an action that’s not listed here, you can get in touch with us to request a new tool, or create your own tools with the Google auth provider.

CreateEvent

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.

Parameters

  • subject (string, required): The text of the event’s subject (title) line.
  • body (string, required): The body of the event.
  • start_date_time (datetime, required): The datetime of the event’s start, represented in ISO 8601 format. Timezone offset is ignored. For example, 2025-04-25T13:00:00
  • end_date_time (datetime, required): The datetime of the event’s end, represented in ISO 8601 format. Timezone offset is ignored. For example, 2025-04-25T13:30:00
  • location (string, optional): The location of the event.
  • attendee_emails (list of strings, optional): The email addresses of the attendees of the event. Must be valid email addresses e.g., username@domain.com.
  • is_online_meeting (bool, optional): Whether the event is an online meeting. Defaults to False

GetEvent

Get an event by its ID from the user’s calendar.

Parameters

  • event_id (string, required): The ID of the event to get.

ListEventsInTimeRange

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.

Parameters

  • start_date_time (datetime, required): The start date and time of the time range, represented in ISO 8601 format. Timezone offset is ignored. For example, 2025-04-24T19:00:00
  • end_date_time (datetime, required): The end date and time of the time range, represented in ISO 8601 format. Timezone offset is ignored. For example, 2025-04-24T19:30:00
  • limit (int, optional): The maximum number of events to return. Max 1000. Defaults to 10.

Auth

The Arcade Outlook Calendar toolkit uses the Microsoft auth provider to connect to users’ Microsoft accounts.

With the hosted Arcade Engine, there’s nothing to configure. Your users will see Arcade as the name of the application that’s requesting permission.

With a self-hosted installation of Arcade, you need to configure the Microsoft auth provider with your own Microsoft app credentials.

Get Building

ReferenceOutlook Mail