Email Automation via macOS Mail.app

This skill uses small bash scripts (AppleScript under the hood) to automate the native macOS Mail.app. Scripts live in the scripts/ subfolder and are intended to be called with parameters instead of editing AppleScript snippets inline.

Requirements

• Mail.app must be configured. Initially assume that it is.
• macOS will prompt for automation permissions the first time.
• ALWAYS confirm with the user before any write action (send, delete, archive, mark read).

Suggested workflow

Use these scripts as a small toolbox. The typical path is:

1. Discover accounts and mailbox names with list_accounts.sh. Treat this as the source of truth for localized mailbox names.
2. When you need a specific message, start with list_recent.sh or search_inbox.sh to get IDs.
3. If the message is older, switch to search_mailbox.sh using the exact mailbox name from step 1.
4. Use IDs for precise actions: read_by_id.sh to inspect, open_by_id.sh to show in Mail.app, reply.sh to draft a reply.
5. For write actions (send.sh, archive_*.sh, delete.sh, mark_read.sh), always confirm with the user first and double-check the ID.