list_messages
Lists emails from a specified Outlook folder with pagination, full-text keyword search, or OData filtering to find messages by sender, read status, or date.
Instructions
List Messages from a mail folder. Use folder 'inbox', 'drafts', 'sentitems', or 'deleteditems' (well-known names), or pass a folderId from list_mail_folders. Supports full-text search and OData filter — but NOT both at once.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | Maximum number of messages to return (default: 50) | |
| skip | No | Number of messages to skip (for pagination) | |
| filter | No | OData filter expression (e.g. 'isRead eq false'). Cannot be combined with search. | |
| folder | No | Folder name or ID to list from. Well-known names: 'inbox', 'drafts', 'sentitems', 'deleteditems'. Default: 'inbox' | |
| search | No | Full-text keyword search (KQL). Cannot be combined with filter. |