> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cassidyai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Outlook calendar events

> Retrieve a list of Outlook Calendar events from a Workflow.

Retrieve a list of events from your Outlook Calendar inside a [Workflow](https://docs.cassidyai.com/workflows/overview.md). Use this action to pull upcoming meetings, create reminders, or generate a daily schedule summary.

**1. Add the action**

In the [Workflow builder](https://docs.cassidyai.com/workflows/building.md), click the **+** button between existing blocks. Select **Get Microsoft Outlook Calendar Events** from the action list.

**2. Connect Microsoft Outlook**

If you haven't already, connect your Microsoft Outlook account to Cassidy by clicking **Connect** and following the on-screen instructions.

![Connecting Microsoft Outlook in the action configuration](https://mintcdn.com/cassidy/NfnWXcqF9xNMFxoX/images/reference/get-microsoft-outlook-calendar-events-img-0.png?fit=max\&auto=format\&n=NfnWXcqF9xNMFxoX\&q=85\&s=04d51270748235006880d703ef69a394)

**3. Rename the action (optional)**

Click the action name to enter a more descriptive label, making it easier to reference later.

![Renaming the Get Microsoft Outlook Calendar Events action](https://mintcdn.com/cassidy/NfnWXcqF9xNMFxoX/images/reference/get-microsoft-outlook-calendar-events-img-1.png?fit=max\&auto=format\&n=NfnWXcqF9xNMFxoX\&q=85\&s=459b7174a25e41c8e92bb40938ce5fc7)

**4. Configure filters (optional)**

Use **Filters** to narrow which events are returned. You can filter by:

* **Start time** — specify when events should begin
* **End time** — specify when events should end
* **Subject** — filter events by title or subject keywords
* **Created date** — filter by when the event was created
* **Last modified** — filter by when the event was last updated

![Filter options for the Get Calendar Events action](https://mintcdn.com/cassidy/NfnWXcqF9xNMFxoX/images/reference/get-microsoft-outlook-calendar-events-img-2.png?fit=max\&auto=format\&n=NfnWXcqF9xNMFxoX\&q=85\&s=08cc7386a70f7137ac0ad89920fbd6e6)

For each row, choose an operator (for example, "Equals" or "Contains"), then enter a value or press **#** to reference a variable. Click **Delete** to remove a filter.

![Configuring a filter row with operator and value](https://mintcdn.com/cassidy/NfnWXcqF9xNMFxoX/images/reference/get-microsoft-outlook-calendar-events-img-3.png?fit=max\&auto=format\&n=NfnWXcqF9xNMFxoX\&q=85\&s=734a1e9322f647df379b8c7c1843e254)

> [!TIP]
>
> Time-based fields are typically handled in UTC, so keep your time format consistent when filtering.

![Time-based filter example for calendar events](https://mintcdn.com/cassidy/NfnWXcqF9xNMFxoX/images/reference/get-microsoft-outlook-calendar-events-img-4.png?fit=max\&auto=format\&n=NfnWXcqF9xNMFxoX\&q=85\&s=6b94dfc6db153de1f8c6cea6fa8c27bd)

**5. Configure order by (optional)**

Determine the order of results by selecting a field to sort by and choosing the sort direction (ascending or descending).

![Order By configuration showing field and direction options](https://mintcdn.com/cassidy/NfnWXcqF9xNMFxoX/images/reference/get-microsoft-outlook-calendar-events-img-5.png?fit=max\&auto=format\&n=NfnWXcqF9xNMFxoX\&q=85\&s=513d8c661e787fbda8a712a9db51c4f0)

**6. Set max results (optional)**

Specify the maximum number of results to return. This helps manage performance and limits the output to a specific number of events.

![Max Results field for limiting the number of returned events](https://mintcdn.com/cassidy/NfnWXcqF9xNMFxoX/images/reference/get-microsoft-outlook-calendar-events-img-6.png?fit=max\&auto=format\&n=NfnWXcqF9xNMFxoX\&q=85\&s=4bd7c5795cffacdda239b0be2ab4aa29)

**7. Toggle include recurring (optional)**

Choose whether to include recurring events in the results. When enabled, the action returns both one-time and recurring calendar events.

![Include Recurring toggle for calendar events](https://mintcdn.com/cassidy/NfnWXcqF9xNMFxoX/images/reference/get-microsoft-outlook-calendar-events-img-7.png?fit=max\&auto=format\&n=NfnWXcqF9xNMFxoX\&q=85\&s=ee83b5320e7742aa0c0c9c34ae4692fb)

**8. Reference the event variables**

After running the Workflow once, use the action outputs in later steps by pressing **#** and selecting fields from the event list. Available variables:

* **Event ID** — unique identifier of the calendar event
* **Title** — title or subject of the calendar event
* **Description** — description or body content of the calendar event
* **Created Date** — when the calendar event was created
* **Updated Date** — when the calendar event was last modified
* **Calendar Event Link** — direct link to view the event in Outlook
* **Start Date** — start date and time of the event
* **End Date** — end date and time of the event
* **Time Zone** — time zone for the event
* **Is All Day** — whether the event is an all-day event
* **Is Online Meeting** — whether the event includes an online meeting
* **Join URL** — meeting link if it's an online meeting
* **Location** — physical location of the event
* **Organizer** — details about who organized the event (name and email)
* **Attendees** — list of people invited to the event

![Variable picker showing available calendar event output fields](https://mintcdn.com/cassidy/NfnWXcqF9xNMFxoX/images/reference/get-microsoft-outlook-calendar-events-img-8.png?fit=max\&auto=format\&n=NfnWXcqF9xNMFxoX\&q=85\&s=7a92cc05e15e7e3144b1297746f61390)

**9. Use a Loop to process events**

Because this action returns a list, add a **Loop** after it when you want to run follow-up steps once per event. Learn more about [using Loops](https://docs.cassidyai.com/workflows/building.md).

![Loop action processing calendar events from the Get Calendar Events output](https://mintcdn.com/cassidy/NfnWXcqF9xNMFxoX/images/reference/get-microsoft-outlook-calendar-events-img-9.png?fit=max\&auto=format\&n=NfnWXcqF9xNMFxoX\&q=85\&s=4982fbf90f133842dab35f3c1e348b18)

## Example: daily meetings summary

Set up a Workflow that checks your daily meetings and sends you a summary each morning.

**1. Add a Scheduled trigger**

Set it to run daily at 9 AM to automatically check your meetings each
morning.

**2. Add a Get Microsoft Outlook Calendar Events action**

Configure filters to retrieve today's events by setting appropriate start
and end time filters.

**3. Add a Loop action**

Loop through each event returned by the Get Calendar Events action.

**4. Inside the Loop, add a Generate Text action**

Use the event's title, description, start time, and attendee information to
create a brief summary for each meeting.

**5. After the Loop, add a Send Slack Message action**

Combine all the meeting summaries and send them to yourself in Slack to
review your day's schedule.

![Example Slack message showing a formatted daily meetings summary](https://mintcdn.com/cassidy/NfnWXcqF9xNMFxoX/images/reference/get-microsoft-outlook-calendar-events-img-10.png?fit=max\&auto=format\&n=NfnWXcqF9xNMFxoX\&q=85\&s=f6a60bad67bc41a56fb976e0f2622f84)

## Output variables

| Variable | Description |
| - | - |
| **Event ID** | Unique identifier of the calendar event |
| **Title** | Title or subject of the calendar event |
| **Description** | Description or body content of the calendar event |
| **Created Date** | When the calendar event was created |
| **Updated Date** | When the calendar event was last modified |
| **Calendar Event Link** | Direct link to view the event in Outlook |
| **Start Date** | Start date and time of the event |
| **End Date** | End date and time of the event |
| **Time Zone** | Time zone for the event |
| **Is All Day** | Whether the event is an all-day event |
| **Is Online Meeting** | Whether the event includes an online meeting |
| **Join URL** | Meeting link if it's an online meeting |
| **Location** | Physical location of the event |
| **Organizer** | Details about who organized the event (name and email) |
| **Attendees** | List of people invited to the event |

## Related

* [New calendar event trigger](https://docs.cassidyai.com/integrations/microsoft-365/outlook-calendar/new-calendar-event-trigger.md)
* [Updated calendar event trigger](https://docs.cassidyai.com/integrations/microsoft-365/outlook-calendar/updated-calendar-event-trigger.md)
* [Create calendar event](https://docs.cassidyai.com/integrations/microsoft-365/outlook-calendar/create-calendar-event.md)
* [Outlook Calendar for Workflows](https://docs.cassidyai.com/integrations/microsoft-365/outlook-calendar/workflows)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.