mail_search_emails

Full-text search across your local mail database using SQLite FTS5 syntax.

Parameters

Parameter	Type	Required	Default	Description
query	string	Yes	—	Search query (FTS5 syntax)
account_id	string	No	—	Filter by account ID
folder_id	string	No	—	Filter by folder ID
limit	integer	No	50	Maximum results
offset	integer	No	0	Number of results to skip

A missing query, a non-string filter, or a negative limit/offset returns JSON-RPC error -32602.

Example

{
  "tool": "mail_search_emails",
  "arguments": {
    "query": "project update",
    "account_id": "acc1",
    "limit": 10
  }
}

Gates and denial reasons

Read tool. Requires Mail enabled, a ready helper, a non-deny global tool policy, and Allow AI to read Mail. Failures return JSON-RPC error -32008 with one of mail_feature_disabled, mail_helper_unavailable, mail_global_policy_denied, or mail_read_consent_required. Full ordering: API Reference.