Skip to content

feat(outlook): add Microsoft Graph calendar operations #6041

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
waleedlatif1 merged 14 commits into from
Jul 29, 2026
Merged

feat(outlook): add Microsoft Graph calendar operations #6041

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
103703e
feat(outlook): add Calendars.ReadWrite and MailboxSettings.Read scopes
mzxchandra Jul 29, 2026
9eefc69
feat(outlook): add Microsoft Graph calendar tools
mzxchandra Jul 29, 2026
fe89723
feat(outlook): surface calendar operations in the Outlook block
mzxchandra Jul 29, 2026
f6e6efb
fix(outlook): address calendar review findings
mzxchandra Jul 29, 2026
0f9b946
feat(outlook): add calendar picker and harden calendar tools
waleedlatif1 Jul 29, 2026
4abde7e
fix(outlook): scope online-meeting comments to what Graph documents
waleedlatif1 Jul 29, 2026
801f442
fix(outlook): allow calendar paging without re-supplying the time window
waleedlatif1 Jul 29, 2026
a0730fc
feat(outlook): add Calendars.ReadWrite.Shared for shared calendars
waleedlatif1 Jul 29, 2026
6ade310
fix(outlook): treat date-only bounds as all-day and guard partial all…
waleedlatif1 Jul 29, 2026
170ddb8
docs(outlook): note that the calendar window fields are ignored when …
waleedlatif1 Jul 29, 2026
a42782d
fix(outlook): don't promote a lone date-only bound to all-day on update
waleedlatif1 Jul 29, 2026
6b6b655
revert(outlook): drop Calendars.ReadWrite.Shared from the outlook pro…
waleedlatif1 Jul 29, 2026
2564def
fix(outlook): make retried event creates duplicate-safe via transacti…
waleedlatif1 Jul 29, 2026
bc55db2
fix(outlook): tighten date-only detection and align online-meeting copy
waleedlatif1 Jul 29, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
230 changes: 228 additions & 2 deletions apps/docs/content/docs/en/integrations/outlook.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Outlook
description: Send, read, search, reply, organize, and manage Outlook email
description: Send, read, search, reply, organize, and manage Outlook email and calendar
---

import { BlockInfoCard } from "@/components/ui/block-info-card"
Expand Down Expand Up @@ -37,7 +37,7 @@ By connecting Sim with Microsoft Outlook, you enable intelligent agents to autom

## Usage Instructions

Integrate Outlook into the workflow. Can send, draft, read, search, reply, forward, move, copy, and delete email; manage mail folders and attachments; and set categories and flags on messages. Can be used in trigger mode to trigger a workflow when a new email is received.
Integrate Outlook into the workflow. Can send, draft, read, search, reply, forward, move, copy, and delete email; manage mail folders and attachments; and set categories and flags on messages. Can also list, create, update, delete, and respond to calendar events. Can be used in trigger mode to trigger a workflow when a new email is received.



Expand Down Expand Up @@ -473,6 +473,232 @@ Get a single attachment on an Outlook message, including its file contents
| ↳ `lastModifiedDateTime` | string | When the attachment was last modified \(ISO 8601\) |
| `attachments` | file[] | The downloaded file attachment \(empty for non-file attachment types\) |

### `outlook_calendar_list_events`

List Outlook calendar events within a start/end time window

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `calendarId` | string | No | ID of the calendar to read. Defaults to the mailbox default calendar. Calendars shared by another user are not supported and may return 403. |
| `startDateTime` | string | No | Start of the time window \(ISO 8601, e.g. 2025-06-03T00:00:00-08:00\). Interpreted as UTC if no offset is given. Required unless paging with pageToken. |
| `endDateTime` | string | No | End of the time window \(ISO 8601, e.g. 2025-06-10T00:00:00-08:00\). Interpreted as UTC if no offset is given. Required unless paging with pageToken. |
| `maxResults` | number | No | Maximum number of events to return per page \(default: 10, max: 100\) |
| `orderBy` | string | No | Order of events \(default: start/dateTime\) |
| `pageToken` | string | No | Full @odata.nextLink URL from a previous page to continue paging |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success or status message |
| `results` | array | Array of calendar event objects |
| ↳ `id` | string | Unique event identifier |
| ↳ `subject` | string | Event subject/title |
| ↳ `bodyPreview` | string | Preview of the event body |
| ↳ `start` | object | Event start |
| ↳ `dateTime` | string | Local date and time \(ISO 8601, no offset\) |
| ↳ `timeZone` | string | IANA or Windows time zone name |
| ↳ `end` | object | Event end |
| ↳ `dateTime` | string | Local date and time \(ISO 8601, no offset\) |
| ↳ `timeZone` | string | IANA or Windows time zone name |
| ↳ `isAllDay` | boolean | Whether the event lasts the entire day |
| ↳ `location` | string | Event location display name |
| ↳ `organizer` | object | Event organizer |
| ↳ `name` | string | Display name of the person or entity |
| ↳ `address` | string | Email address |
| ↳ `attendees` | array | Event attendees |
| ↳ `name` | string | Attendee display name |
| ↳ `address` | string | Attendee email address |
| ↳ `type` | string | Attendee type \(required, optional, or resource\) |
| ↳ `response` | string | Attendee response status \(none, accepted, declined, tentativelyAccepted, ...\) |
| ↳ `onlineMeeting` | object | Online-meeting join details, if any |
| ↳ `joinUrl` | string | URL to join the online meeting |
| ↳ `webLink` | string | URL that opens the event in Outlook on the web |
| `nextLink` | string | URL for the next page of results, if any |

### `outlook_calendar_get_event`

Get a single Outlook calendar event by ID

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `eventId` | string | Yes | The ID of the calendar event to retrieve |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success or status message |
| `results` | object | The calendar event object |
| ↳ `id` | string | Unique event identifier |
| ↳ `subject` | string | Event subject/title |
| ↳ `bodyPreview` | string | Preview of the event body |
| ↳ `start` | object | Event start |
| ↳ `dateTime` | string | Local date and time \(ISO 8601, no offset\) |
| ↳ `timeZone` | string | IANA or Windows time zone name |
| ↳ `end` | object | Event end |
| ↳ `dateTime` | string | Local date and time \(ISO 8601, no offset\) |
| ↳ `timeZone` | string | IANA or Windows time zone name |
| ↳ `isAllDay` | boolean | Whether the event lasts the entire day |
| ↳ `location` | string | Event location display name |
| ↳ `organizer` | object | Event organizer |
| ↳ `name` | string | Display name of the person or entity |
| ↳ `address` | string | Email address |
| ↳ `attendees` | array | Event attendees |
| ↳ `name` | string | Attendee display name |
| ↳ `address` | string | Attendee email address |
| ↳ `type` | string | Attendee type \(required, optional, or resource\) |
| ↳ `response` | string | Attendee response status \(none, accepted, declined, tentativelyAccepted, ...\) |
| ↳ `onlineMeeting` | object | Online-meeting join details, if any |
| ↳ `joinUrl` | string | URL to join the online meeting |
| ↳ `webLink` | string | URL that opens the event in Outlook on the web |

### `outlook_calendar_create_event`

Create a new Outlook calendar event

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `calendarId` | string | No | ID of the calendar to create the event in. Defaults to the mailbox default calendar. Calendars shared by another user are not supported and may return 403. |
| `subject` | string | Yes | Event subject/title |
| `startDateTime` | string | Yes | Start time \(ISO 8601, e.g. 2025-06-03T10:00:00-08:00\). A date-only value \(2025-06-03\) for both start and end creates an all-day event. |
| `endDateTime` | string | Yes | End time \(ISO 8601, e.g. 2025-06-03T11:00:00-08:00\). A date-only value \(2025-06-04\) for both start and end creates an all-day event. |
| `timeZone` | string | No | IANA or Windows time zone name \(e.g. America/Los_Angeles\). Used for datetimes without a UTC offset. Defaults to UTC. |
| `body` | string | No | Event body content |
| `contentType` | string | No | Content type for the event body \(text or html\) |
| `location` | string | No | Event location display name |
| `attendees` | string | No | Attendee email addresses \(comma-separated\) |
| `isAllDay` | boolean | No | Whether the event lasts the entire day |
| `isOnlineMeeting` | boolean | No | Attach an online meeting to the event. The join URL depends on the meeting providers the mailbox allows \(Teams on work/school accounts\); personal accounts have no supported provider, so onlineMeeting.joinUrl stays null there. |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success or status message |
| `results` | object | The created calendar event object |
| ↳ `id` | string | Unique event identifier |
| ↳ `subject` | string | Event subject/title |
| ↳ `bodyPreview` | string | Preview of the event body |
| ↳ `start` | object | Event start |
| ↳ `dateTime` | string | Local date and time \(ISO 8601, no offset\) |
| ↳ `timeZone` | string | IANA or Windows time zone name |
| ↳ `end` | object | Event end |
| ↳ `dateTime` | string | Local date and time \(ISO 8601, no offset\) |
| ↳ `timeZone` | string | IANA or Windows time zone name |
| ↳ `isAllDay` | boolean | Whether the event lasts the entire day |
| ↳ `location` | string | Event location display name |
| ↳ `organizer` | object | Event organizer |
| ↳ `name` | string | Display name of the person or entity |
| ↳ `address` | string | Email address |
| ↳ `attendees` | array | Event attendees |
| ↳ `name` | string | Attendee display name |
| ↳ `address` | string | Attendee email address |
| ↳ `type` | string | Attendee type \(required, optional, or resource\) |
| ↳ `response` | string | Attendee response status \(none, accepted, declined, tentativelyAccepted, ...\) |
| ↳ `onlineMeeting` | object | Online-meeting join details, if any |
| ↳ `joinUrl` | string | URL to join the online meeting |
| ↳ `webLink` | string | URL that opens the event in Outlook on the web |

### `outlook_calendar_update_event`

Update an existing Outlook calendar event

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `eventId` | string | Yes | The ID of the calendar event to update |
| `subject` | string | No | New event subject/title |
| `startDateTime` | string | No | New start time \(ISO 8601\). A date-only value \(2025-06-03\) converts the event to all-day. |
| `endDateTime` | string | No | New end time \(ISO 8601\). A date-only value \(2025-06-04\) converts the event to all-day. |
| `timeZone` | string | No | IANA or Windows time zone name applied to updated datetimes without a UTC offset. Defaults to UTC. |
| `body` | string | No | New event body content |
| `contentType` | string | No | Content type for the event body \(text or html\) |
| `location` | string | No | New event location display name |
| `attendees` | string | No | Replacement attendee email addresses \(comma-separated\) |
| `isAllDay` | boolean | No | Whether the event lasts the entire day. Setting this true requires also sending startDateTime, since Graph needs midnight bounds. |
| `isOnlineMeeting` | boolean | No | Attach an online meeting to the event. The join URL depends on the meeting providers the mailbox allows \(Teams on work/school accounts\); personal accounts have no supported provider, so onlineMeeting.joinUrl stays null there. |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success or status message |
| `results` | object | The updated calendar event object |
| ↳ `id` | string | Unique event identifier |
| ↳ `subject` | string | Event subject/title |
| ↳ `bodyPreview` | string | Preview of the event body |
| ↳ `start` | object | Event start |
| ↳ `dateTime` | string | Local date and time \(ISO 8601, no offset\) |
| ↳ `timeZone` | string | IANA or Windows time zone name |
| ↳ `end` | object | Event end |
| ↳ `dateTime` | string | Local date and time \(ISO 8601, no offset\) |
| ↳ `timeZone` | string | IANA or Windows time zone name |
| ↳ `isAllDay` | boolean | Whether the event lasts the entire day |
| ↳ `location` | string | Event location display name |
| ↳ `organizer` | object | Event organizer |
| ↳ `name` | string | Display name of the person or entity |
| ↳ `address` | string | Email address |
| ↳ `attendees` | array | Event attendees |
| ↳ `name` | string | Attendee display name |
| ↳ `address` | string | Attendee email address |
| ↳ `type` | string | Attendee type \(required, optional, or resource\) |
| ↳ `response` | string | Attendee response status \(none, accepted, declined, tentativelyAccepted, ...\) |
| ↳ `onlineMeeting` | object | Online-meeting join details, if any |
| ↳ `joinUrl` | string | URL to join the online meeting |
| ↳ `webLink` | string | URL that opens the event in Outlook on the web |

### `outlook_calendar_delete_event`

Delete an Outlook calendar event by ID

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `eventId` | string | Yes | The ID of the calendar event to delete |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success or status message |
| `results` | object | Delete result details |
| ↳ `eventId` | string | ID of the deleted event |
| ↳ `status` | string | Deletion status |

### `outlook_calendar_respond`

Accept, tentatively accept, or decline an Outlook calendar event invitation

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `eventId` | string | Yes | The ID of the calendar event to respond to |
| `responseType` | string | Yes | The response: accept, tentativelyAccept, or decline |
| `comment` | string | No | Optional comment to include with the response |
| `sendResponse` | boolean | No | Whether to send a response to the organizer \(default: true\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success or status message |
| `results` | object | Response result details |
| ↳ `eventId` | string | ID of the event responded to |
| ↳ `responseType` | string | The response that was sent |
| ↳ `status` | string | Response status |
| ↳ `httpStatus` | number | HTTP status code returned by the API |
| ↳ `requestId` | string | Microsoft Graph request-id header for tracing |



## Triggers
Expand Down
Loading
Loading