List all configured email accounts in Apple Mail.

Returns: List of account dictionaries with 'name' and 'id' fields.

Example: >>> list_accounts() [{"name": "Work", "id": "abc123"}, {"name": "Personal", "id": "def456"}]

List all mailboxes for an email account.

Args: account: Account name. Uses JXA_MAIL_DEFAULT_ACCOUNT env var or first account if not specified.

Returns: List of mailbox dictionaries with 'name' and 'unreadCount' fields.

Example: >>> list_mailboxes("Work") [{"name": "INBOX", "unreadCount": 5}, ...]

Get emails from a mailbox.

Retrieves emails with standard properties: id, subject, sender, date_received, read status, and flagged status.

Args: account: Account name. Uses JXA_MAIL_DEFAULT_ACCOUNT env var or first account if not specified. mailbox: Mailbox name. Uses JXA_MAIL_DEFAULT_MAILBOX env var or "Inbox" if not specified. limit: Maximum number of emails to return (default: 50)

Returns: List of email dictionaries sorted by date (newest first).

Example: >>> get_emails("Work", "INBOX", limit=10) [{"subject": "Meeting tomorrow", "sender": "boss@work.com", ...}, ...]

Get all emails received today from a mailbox.

Args: account: Account name. Uses JXA_MAIL_DEFAULT_ACCOUNT env var or first account if not specified. mailbox: Mailbox name. Uses JXA_MAIL_DEFAULT_MAILBOX env var or "Inbox" if not specified.

Returns: List of today's emails sorted by date (newest first).

Example: >>> get_todays_emails("Work") [{"subject": "Urgent: Review needed", "sender": "team@work.com", ...}]

Get unread emails from a mailbox.

Args: account: Account name. Uses JXA_MAIL_DEFAULT_ACCOUNT env var or first account if not specified. mailbox: Mailbox name. Uses JXA_MAIL_DEFAULT_MAILBOX env var or "Inbox" if not specified. limit: Maximum number of emails to return (default: 50)

Returns: List of unread emails sorted by date (newest first).

Example: >>> get_unread_emails("Work", limit=20) [{"subject": "New message", "read": false, ...}, ...]

Get flagged emails from a mailbox.

Args: account: Account name. Uses JXA_MAIL_DEFAULT_ACCOUNT env var or first account if not specified. mailbox: Mailbox name. Uses JXA_MAIL_DEFAULT_MAILBOX env var or "Inbox" if not specified. limit: Maximum number of emails to return (default: 50)

Returns: List of flagged emails sorted by date (newest first).

Example: >>> get_flagged_emails("Work") [{"subject": "Important task", "flagged": true, ...}, ...]

Search for emails matching a query string.

Searches in both subject and sender fields (case-insensitive).

Args: query: Search term to look for account: Account name. Uses JXA_MAIL_DEFAULT_ACCOUNT env var or first account if not specified. mailbox: Mailbox name. Uses JXA_MAIL_DEFAULT_MAILBOX env var or "Inbox" if not specified. limit: Maximum number of results (default: 50)

Returns: List of matching emails sorted by date (newest first).

Example: >>> search_emails("invoice", "Work") [{"subject": "Invoice #123", "sender": "billing@vendor.com", ...}]