Apple Mail AppleScript Skill

This skill provides comprehensive guidance on using AppleScript to automate Apple Mail operations, including reading emails, sending messages, and managing mailboxes.

Core Principles

1. Access mailboxes through account objects - Don't try to access inbox directly on accounts
2. Iterate through mailboxes to find the right one - Mailbox names can vary (INBOX, Inbox, etc.)
3. Use account name matching - Match on account name rather than email address property
4. Handle errors gracefully - AppleScript errors can be cryptic, use trial and error with different approaches

Common Query Patterns

1. List All Mail Accounts

Always start by listing accounts to verify the account exists and get the correct name: