naftiko/skills/list-messages
skills/list-messages/SKILL.md
# List Messages in Mailbox Retrieves a collection of messages from the signed-in user's mailbox, supporting filtering, searching, sorting, and pagination through OData query parameters. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: GET - **Path**: `/me/messages` - **Operation ID**: `listMessages` - **Tag**: Messages - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/micr
development
Updated Apr 8, 2026
$ install --global
skillsauthnpx skillsauth add naftiko/microsoft-outlook-sandbox skills/list-messagesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 8, 2026, 2:19 AM31.6s1 file scanned
SKILL.md
List Messages in Mailbox
Retrieves a collection of messages from the signed-in user's mailbox, supporting filtering, searching, sorting, and pagination through OData query parameters.
API Details
- API: Microsoft Outlook Mail API
- Method: GET
- Path:
/me/messages - Operation ID:
listMessages - Tag: Messages
- OpenAPI: microsoft-outlook-mail-api.yaml
Sandbox
Mock server URL: http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/messages
Required Headers
Authorization: Bearer {access-token}
OAuth Scopes
Mail.ReadMail.ReadWrite
Query Parameters
| Parameter | Type | Description |
|-----------|------|-------------|
| $top | integer | Number of results to return |
| $skip | integer | Number of results to skip |
| $select | string | Comma-separated list of properties to include |
| $filter | string | OData filter expression |
| $search | string | Search expression to match messages |
| $orderby | string | Property and direction to sort by |
| $count | boolean | Include total count of matching results |
Example Request
curl -X GET "http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/messages?$top=10&$select=subject,from,receivedDateTime&$orderby=receivedDateTime desc" \
-H "Authorization: Bearer {access-token}"
Example Response
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#me/messages",
"value": [
{
"id": "AAMkAGI1AAAGB1rUAAA=",
"subject": "Quarterly Review Meeting",
"bodyPreview": "Please join us for the quarterly review...",
"body": {"contentType": "html", "content": "<html><body>Please join us for the quarterly review...</body></html>"},
"importance": "normal",
"isRead": false,
"isDraft": false,
"hasAttachments": false,
"from": {"emailAddress": {"name": "Alex Wilber", "address": "[email protected]"}},
"toRecipients": [{"emailAddress": {"name": "Megan Bowen", "address": "[email protected]"}}],
"createdDateTime": "2024-01-15T10:30:00Z",
"receivedDateTime": "2024-01-15T10:30:00Z",
"parentFolderId": "AAMkAGI1AAAEJAAA="
}
]
}
Instructions
Use this operation to retrieve messages from a user's mailbox. Apply $filter to narrow results by criteria such as isRead eq false or from/emailAddress/address eq '[email protected]'. Use $search for keyword-based searches across message content. Combine $top and $skip for pagination, and use $select to limit the properties returned for better performance. Results are returned in descending order by receivedDateTime by default.
Related Skills
naftiko/skills/update-open-extension
tools
VerifiedTrustedCommunity
# 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
SKILL.mdUpdated Apr 8, 2026
naftiko/skills/update-message
development
VerifiedTrustedCommunity
# 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-
SKILL.mdUpdated Apr 8, 2026
naftiko/skills/update-message-rule
development
VerifiedTrustedCommunity
# 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
SKILL.mdUpdated Apr 8, 2026
naftiko/skills/update-mailbox-settings
development
VerifiedTrustedCommunity
# 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
SKILL.mdUpdated Apr 8, 2026