List incoming mail accounts discovered from Thunderbird (with their on-disk store).

List mbox folder names for an account (by email address).

Search a folder's mbox.

Filters are ANDed and case-insensitive substring matches. since/before take ISO dates (YYYY-MM-DD). Without account, searches every account's folder. Returns summaries with an opaque id for read/extract. Note: searching a very large folder streams the whole file and can take a few seconds; narrow with account and a tight limit when possible.

Read one message by its id (from search_mail): headers + decoded body.

List attachment filenames on a message.

Save a message's attachments to dest_dir; returns the written file paths.

List send-from identities and whether each can send right now.

Send mail from one of your identities (SMTP), then file a copy in Sent.

from_address must be a configured identity (see list_identities). Multiple recipients may be comma-separated. Hotmail/Outlook send is not available in v1 and returns a clear error.

SAFETY: dry_run defaults to True — it returns a preview without sending. Pass dry_run=False to actually send.

Re-read Thunderbird prefs.js and credentials.toml (after editing either).