> ## 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](/workflows/overview). Use this action to pull upcoming meetings, create reminders, or generate a daily schedule summary.

<Steps>
  <Step title="Add the action">
    In the [Workflow builder](/workflows/building), click the **+** button between existing blocks. Select **Get Microsoft Outlook Calendar Events** from the action list.
  </Step>

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

    <Frame>
      <img src="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" alt="Connecting Microsoft Outlook in the action configuration" width="485" height="337" data-path="images/reference/get-microsoft-outlook-calendar-events-img-0.png" />
    </Frame>
  </Step>

  <Step title="Rename the action (optional)">
    Click the action name to enter a more descriptive label, making it easier to reference later.

    <Frame>
      <img src="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" alt="Renaming the Get Microsoft Outlook Calendar Events action" width="975" height="339" data-path="images/reference/get-microsoft-outlook-calendar-events-img-1.png" />
    </Frame>
  </Step>

  <Step title="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

    <Frame>
      <img src="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" alt="Filter options for the Get Calendar Events action" width="803" height="542" data-path="images/reference/get-microsoft-outlook-calendar-events-img-2.png" />
    </Frame>

    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.

    <Frame>
      <img src="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" alt="Configuring a filter row with operator and value" width="756" height="700" data-path="images/reference/get-microsoft-outlook-calendar-events-img-3.png" />
    </Frame>

    <Tip>Time-based fields are typically handled in UTC, so keep your time format consistent when filtering.</Tip>

    <Frame>
      <img src="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" alt="Time-based filter example for calendar events" width="767" height="459" data-path="images/reference/get-microsoft-outlook-calendar-events-img-4.png" />
    </Frame>
  </Step>

  <Step title="Configure order by (optional)">
    Determine the order of results by selecting a field to sort by and choosing the sort direction (ascending or descending).

    <Frame>
      <img src="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" alt="Order By configuration showing field and direction options" width="755" height="220" data-path="images/reference/get-microsoft-outlook-calendar-events-img-5.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="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" alt="Max Results field for limiting the number of returned events" width="769" height="222" data-path="images/reference/get-microsoft-outlook-calendar-events-img-6.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="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" alt="Include Recurring toggle for calendar events" width="761" height="125" data-path="images/reference/get-microsoft-outlook-calendar-events-img-7.png" />
    </Frame>
  </Step>

  <Step title="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

    <Frame>
      <img src="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" alt="Variable picker showing available calendar event output fields" width="975" height="743" data-path="images/reference/get-microsoft-outlook-calendar-events-img-8.png" />
    </Frame>
  </Step>

  <Step title="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](/workflows/building).

    <Frame>
      <img src="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" alt="Loop action processing calendar events from the Get Calendar Events output" width="975" height="726" data-path="images/reference/get-microsoft-outlook-calendar-events-img-9.png" />
    </Frame>
  </Step>
</Steps>

## Example: daily meetings summary

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

<Steps>
  <Step title="Add a Scheduled trigger">
    Set it to run daily at 9 AM to automatically check your meetings each morning.
  </Step>

  <Step title="Add a Get Microsoft Outlook Calendar Events action">
    Configure filters to retrieve today's events by setting appropriate start and end time filters.
  </Step>

  <Step title="Add a Loop action">
    Loop through each event returned by the Get Calendar Events action.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Frame>
  <img src="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" alt="Example Slack message showing a formatted daily meetings summary" width="975" height="705" data-path="images/reference/get-microsoft-outlook-calendar-events-img-10.png" />
</Frame>

## 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](/integrations/microsoft-365/outlook/new-calendar-event-trigger)
* [Updated calendar event trigger](/integrations/microsoft-365/outlook/updated-calendar-event-trigger)
* [Create calendar event](/integrations/microsoft-365/outlook/create-calendar-event)
* [Outlook Calendar for Workflows](/integrations/microsoft-365/outlook/calendar-workflows)