list-mail-folder-messages
Retrieve email messages from a specific Microsoft 365 mailbox folder using search filters and property queries to locate relevant communications.
Instructions
Get all the messages in the specified user's mailbox, or those messages in a specified folder in the mailbox.
💡 TIP: CRITICAL: When searching emails, the $search parameter value MUST be wrapped in double quotes. Format: $search="your search query here". Use KQL (Keyword Query Language) syntax to search specific properties: 'from:', 'subject:', 'body:', 'to:', 'cc:', 'bcc:', 'attachment:', 'hasAttachments:', 'importance:', 'received:', 'sent:'. Examples: $search="from:john@example.com" | $search="subject:meeting AND hasAttachments:true" | $search="body:urgent AND received>=2024-01-01" | $search="from:alice AND importance:high". Remember: ALWAYS wrap the entire search expression in double quotes! Reference: https://learn.microsoft.com/en-us/graph/search-query-parameter
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | Show only the first n items | |
| skip | No | Skip the first n items | |
| search | No | Search items by search phrases | |
| filter | No | Filter items by property values | |
| count | No | Include count of items | |
| orderby | No | Order items by property values | |
| select | No | Select properties to be returned | |
| expand | No | Expand related entities | |
| mailFolderId | Yes | Path parameter: mailFolderId | |
| fetchAllPages | No | Automatically fetch all pages of results | |
| includeHeaders | No | Include response headers (including ETag) in the response metadata | |
| excludeResponse | No | Exclude the full response body and only return success or failure indication |