Search emails using mu find query syntax.

Examples: 'from:alice subject:report date:2w..'

sort_field: one of date, from, to, subject, size, maildir (default: date) sort_order: "desc" for newest/largest first, "asc" for oldest/smallest first

Count emails matching a query without fetching their content.

Use this when the user asks 'how many emails' rather than asking to see them.

Search contacts by name or email address using mu cfind.

Use this to resolve a person's name to their exact email address before searching emails with from: or to: filters.

List all maildirs in the mu index.

Call this first to discover maildir names before using maildir: in queries.

Get the full content of an email by its file path.

The path is obtained from the path field of search_emails results. Returns the raw email text including headers and body.