search_emails_advanced
Search all email accounts and mailboxes using filters for subject, sender, date, read status, attachments, and more. IMAP-enabled for fast results.
Instructions
Powerful unified search across accounts and mailboxes with flexible filters.
Combines the capabilities of search_emails, search_by_sender, search_email_content, and search_all_accounts into one tool. When account is None, all accounts are searched.
Uses IMAP when available (much faster, no Mail.app freezes). Falls back to AppleScript for accounts without IMAP configuration.
Args: account: Account to search (None = all accounts) mailbox: Mailbox name (default "INBOX", "All" for all mailboxes) subject_contains: Filter by subject keyword (case-insensitive) body_contains: Filter by body text (slower, case-insensitive) sender_contains: Filter by sender name/email (case-insensitive) to_contains: Filter by To recipient address (case-insensitive, IMAP-accelerated) cc_contains: Filter by CC recipient address (case-insensitive, IMAP-accelerated) date_from: Start date "YYYY-MM-DD" (inclusive) date_to: End date "YYYY-MM-DD" (inclusive) is_read: Filter by read status (True/False/None for any) has_attachments: Filter by attachment presence (True/False/None) is_flagged: Filter by flagged status (True/False/None) max_results: Maximum results (default 50) offset: Skip first N results for pagination (default 0) output_format: "text" (human-readable) or "json" (structured)
Returns: Matching emails across the specified scope
User Preferences: {"workflow": "default", "notifications": "enabled"}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| offset | No | ||
| account | No | ||
| date_to | No | ||
| is_read | No | ||
| mailbox | No | INBOX | |
| date_from | No | ||
| is_flagged | No | ||
| cc_contains | No | ||
| max_results | No | ||
| to_contains | No | ||
| body_contains | No | ||
| output_format | No | text | |
| has_attachments | No | ||
| sender_contains | No | ||
| subject_contains | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |