List messages
list_messagesRetrieve recent Outlook emails with optional folder and unread filters, returning compact summaries with key details for quick triage.
Instructions
List messages, most recent first. Optionally scope to a folder and/or only unread messages. Returns compact summaries (id, subject, from, received, isRead, hasAttachments, preview). Fetch full bodies with get_message.
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 messages to return (capped by OUTLOOK_MAX_RESULTS) | |
| folder | No | Mail folder id or well-known name (inbox, sentitems, drafts, archive, deleteditems). Defaults to the whole mailbox. | |
| unread_only | No | Only return unread messages |