Automating Apple Mail (JXA-first, AppleScript discovery)

Contents

• Relationship to macOS automation skill
• Core Framing
• Workflow
• Quick Start Examples
• Validation Checklist
• When Not to Use
• What to load

Relationship to the macOS automation skill

• Use automating-mac-apps for permissions, shell, and UI scripting guidance.
• PyXA Installation: See automating-mac-apps skill (PyXA Installation section).

Core Framing

• Mail dictionary is AppleScript-first; discover in Script Editor.
• Objects are specifiers: read via method calls (message.subject()), modify via assignments (message.readStatus = true).
• ObjC bridge available for advanced filesystem operations.