graph_search_mail
Search Outlook emails by keyword, optionally scoped to a folder or shared mailbox, and page through large result sets with compact fields.
Instructions
Search emails by keyword.
Args: query: Search query string. top: Maximum number of results (default 25). folder: Mail folder name or ID to search (default "", the whole mailbox). Scope the search to a folder when the mailbox holds thousands of messages. compact: Whether to return only the identifying fields instead of the full record (default false). Use it to page through large collections cheaply. next_link: Opaque nextLink URL from a previous call, used to fetch the next page. Overrides the other paging arguments when supplied. include_next_link: Whether to wrap the result as {items, next_link} so paging can continue (default false, which returns a bare list). immutable_ids: Whether to ask Graph for immutable message IDs (default false). A message ID changes when the message is moved, so a stored ID stops working; an immutable ID survives the move. mailbox: Shared mailbox address or user ID to act on. Empty targets your own mailbox. Requires the delegated Mail.*.Shared permissions.
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": "graph_search_mail"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | ||
| query | Yes | ||
| folder | No | ||
| compact | No | ||
| mailbox | No | ||
| next_link | No | ||
| immutable_ids | No | ||
| include_next_link | No |