skills/list-user-calendars/SKILL.md
# List User Calendars Retrieves all calendars belonging to the authenticated user. Use this operation to enumerate a user's calendars, optionally filtering or selecting specific properties. ## API Details - **API**: Microsoft Outlook Calendar API - **Method**: GET - **Path**: `/me/calendars` - **Operation ID**: `listUserCalendars` - **Tag**: Calendars - **OpenAPI**: [microsoft-outlook-calendar-api.yaml](../../openapi/microsoft-outlook-calendar-api.yaml) ## Sandbox Mock server URL: `http://l
npx skillsauth add naftiko/microsoft-outlook-sandbox skills/list-user-calendarsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Retrieves all calendars belonging to the authenticated user. Use this operation to enumerate a user's calendars, optionally filtering or selecting specific properties.
/me/calendarslistUserCalendarsMock server URL: http://localhost:8080/rest/microsoft-outlook-calendar-api/1.0.0/me/calendars
Authorization: Bearer {access-token}Calendars.ReadCalendars.ReadWriteCalendars.Read.SharedCalendars.ReadWrite.Shared| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| $top | integer | No | Maximum number of results to return |
| $skip | integer | No | Number of results to skip |
| $filter | string | No | OData filter expression |
| $select | string | No | Comma-separated list of properties to include |
| $orderby | string | No | OData orderby expression |
curl -X GET "http://localhost:8080/rest/microsoft-outlook-calendar-api/1.0.0/me/calendars?$top=10" \
-H "Authorization: Bearer {access-token}"
{
"value": [
{
"id": "AAMkAGI1AAA=",
"name": "Calendar",
"color": "auto",
"isDefaultCalendar": true,
"canEdit": true,
"canShare": true,
"canViewPrivateItems": true,
"owner": {
"name": "Jane Smith",
"address": "[email protected]"
}
}
]
}
Use this operation when you need to retrieve a list of all calendars for the authenticated user. This is useful for discovering available calendars before performing operations on specific ones, such as listing events or creating new events in a particular calendar.
tools
# Update Open Extension Update an existing open type extension on a message. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: PATCH - **Path**: `/me/messages/{message-id}/extensions/{extension-id}` - **Operation ID**: `updateOpenExtension` - **Tag**: Extensions - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/messages/{message-id}/exten
development
# Update Message Updates the properties of an existing message in the signed-in user's mailbox, such as marking it as read or changing its importance. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: PATCH - **Path**: `/me/messages/{message-id}` - **Operation ID**: `updateMessage` - **Tag**: Messages - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-outlook-mail-
development
# Update Inbox Rule Update the properties of an existing inbox message rule. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: PATCH - **Path**: `/me/mailFolders/inbox/messageRules/{messageRule-id}` - **Operation ID**: `updateMessageRule` - **Tag**: InboxRules - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/mailFolders/inbox/messageRule
development
# Update Mailbox Settings Update the user's mailbox settings such as automatic replies, locale, time zone, or working hours. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: PATCH - **Path**: `/me/mailboxSettings` - **Operation ID**: `updateMailboxSettings` - **Tag**: MailboxSettings - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/mail