Search Email
search_messagesSearch email messages by query to locate specific mail in a user's mailbox or an allowed shared mailbox. Returns matching results with an optional limit on how many to return.
Instructions
Search email messages
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": {
"query": "<query>"
},
"name": "search_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | Number of results to return (default: 25) | |
| query | Yes | Search query string | |
| mailbox | No | Email address of another mailbox to act on (delegated or shared), e.g. 'someone@example.com'. Omit for your own mailbox; required when this server signs in as an application. Only addresses this server is configured to allow will be accepted. |