Tool

search_emails

Search email

Read-onlyIdempotent

SurfacesChat agentMCPCLI

Full-text search the user's mail by subject, sender, or body. Call this to find relevant emails BEFORE answering — never answer from memory about specific mail. Returns matching messages with threadId, inboxId, subject, sender, and a body preview.

CLI: tinbox search-emails

Parameters

Name	Type	Required	Description
`query`	string	yes	Search terms (e.g. 'refund', 'invoice March').
`inboxId`	string	no	Optional: restrict to one inbox id. Omit to search all accessible inboxes.

Example

json

{
  "query": "invoice"
}