apple-mail-jxa - Operate Apple Mail with native JXA
Use macOS Mail.app JXA and optional read-only Envelope Index SQLite search to discover, search, read, draft, send, modify, and manage messages.
Tags
Updated: 2026-10-02Capabilities
Typical Inputs
Typical Outputs
What this skill does
- Discover accounts and mailboxes
- Search mailbox messages
- Search global metadata
- Read message bodies
- Read message sources
- Create visible drafts
- Send messages
- Reply to messages
- Forward messages
- Move messages
- Delete messages
- Change message flags
- Change read state
- Synchronize Mail.app
- Emit JSON results
- Emit sanitized errors
Inputs
- Operation request
- Account IDs
- Mailbox paths
- Message references
- Search criteria
- Message content
- Recipients
- Attachments
- Mutation confirmation
Outputs
- JSON results on stdout
- Sanitized errors on stderr
- Visible Mail.app drafts
- Sent messages
- Updated mail state
- Moved messages
- Deleted messages
Requirements
- macOS Mail.app
- osascript with JXA
- Mail Automation permission
- Full Disk Access for Envelope Index search
- System Keychain access