m365_search_emails
Microsoft 365 · macOS · Windows
Effect: read (strongest supported action). Status: gated.
Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.
macOS
Purpose
Use this when the user wants to find emails in their Microsoft 365 / Outlook mailbox via the cloud — requires a connected M365 account. By default searches sender, subject, AND body (Microsoft Graph's own $search default). Pass scope="metadata" to search only sender/subject (faster, no body scan), or scope="body" to search only the message body. For accounts added to the Mac's Mail.app, use search_emails.
Required inputs
query— Search query, e.g. 'budget Q2', 'from:[email protected]', 'subject:invoice'
Permissions and confirmation
No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.
- Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.
Full input schema — macOS
{
"properties": {
"limit": {
"description": "Max results (default 20, max 50)",
"type": "integer"
},
"query": {
"description": "Search query, e.g. 'budget Q2', 'from:[email protected]', 'subject:invoice'",
"type": "string"
},
"scope": {
"description": "\"all\" (default — sender+subject+body, today's behavior), \"metadata\" (sender+subject only), or \"body\" (body only).",
"enum": [
"metadata",
"body",
"all"
],
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
}Documentation example
Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.
{
"query": "launch checklist"
}Windows
Purpose
Search your Microsoft 365 emails by keyword, sender, or subject.
Required inputs
query— Search query, e.g. 'budget Q2', 'from:[email protected]', 'subject:invoice'
Permissions and confirmation
No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.
- Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.
Full input schema — Windows
{
"properties": {
"limit": {
"description": "Max results (default 20, max 50)",
"type": "number"
},
"query": {
"description": "Search query, e.g. 'budget Q2', 'from:[email protected]', 'subject:invoice'",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
}Documentation example
Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.
{
"query": "launch checklist"
}