skills/list-mail-folders/SKILL.md
# List Mail Folders List all mail folders in the authenticated user's mailbox, including built-in folders like Inbox, Drafts, and Sent Items, as well as custom folders. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: GET - **Path**: `/me/mailFolders` - **Operation ID**: `listMailFolders` - **Tag**: MailFolders - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-ou
npx skillsauth add naftiko/microsoft-outlook-sandbox skills/list-mail-foldersInstall 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.
List all mail folders in the authenticated user's mailbox, including built-in folders like Inbox, Drafts, and Sent Items, as well as custom folders.
/me/mailFolderslistMailFoldersMock server URL: http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/mailFolders
Authorization: Bearer {access-token}Mail.ReadMail.ReadWrite| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| $top | integer | No | Maximum number of folders to return |
| $skip | integer | No | Number of folders to skip for pagination |
| $filter | string | No | OData filter expression to filter results |
curl -X GET "http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/mailFolders?$top=10" \
-H "Authorization: Bearer {access-token}"
{
"value": [
{
"id": "AAMkAGI1AAAEJAAA=",
"displayName": "Inbox",
"parentFolderId": "AAMkAGI1AAAAAA=",
"childFolderCount": 2,
"totalItemCount": 147,
"unreadItemCount": 12,
"isHidden": false
}
]
}
Use this operation to retrieve a list of all mail folders in the user's mailbox. This is useful for discovering available folders before performing operations like moving messages or listing folder contents. Use query parameters to paginate through large folder lists or filter for specific folders.
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