apple-mail-search

You can search Apple Mail messages quickly by performing a SQLite-backed read-only search over the Envelope Index, applying subject, sender, recipient, and date filters to locate specific emails without opening the Mail application.

Yes, you can extract full email bodies on demand using AppleScript, allowing you to retrieve and read message content directly from the command line interface without needing to open or interact with the Mail.app graphical interface.

No, copying the Envelope Index database is not required as it defaults to a read-only access mode, but an optional copy mode is supported if you prefer to work on a duplicate database for additional safety.

You can filter Apple Mail searches by sender and date range by passing specific metadata constraints to the CLI, which queries the SQLite Envelope Index and returns matching envelopes with pagination support for browsing results.

The best way to locate unread Apple Mail messages is to run a CLI search against the Envelope Index, filtering by read status to quickly return metadata for unread emails and optionally fetching their bodies using AppleScript.

Yes, the CLI interface allows you to target a specific database path, enabling you to point the SQLite search at a custom or copied Envelope Index file instead of using the default system location.