list_messages
List message summaries from an Apple Mail mailbox by account and mailbox; filter for unread or set a result limit. Read-only; email bodies are excluded.
Instructions
List message summaries from an Apple Mail mailbox. Read-only; bodies are not included.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"account": "<account>"
},
"name": "list_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of messages to return. | |
| account | Yes | Apple Mail account name. | |
| mailbox | No | Mailbox name. Usually INBOX. | INBOX |
| unread_only | No | Return only unread messages. |