mail

name	mail
description	Reading and managing Apple Mail via JXA. Use when working with email, archiving messages, or processing the inbox.

Mail

Apple Mail automation via JXA (osascript -l JavaScript).

Archiving

Mail.app delete() moves messages to Trash, not Archive. There is no archiveMailbox property — find the archive mailbox by name per account.

See archiving.md for account detection, mailbox lookup, and batch archive patterns.

Reading

var app = Application("Mail");
var inbox = app.inbox();
var messages = inbox.messages();

Key properties: subject(), sender(), dateReceived(), content(), mailbox().account().

Notes

• JXA arrays from Mail may lack .map()/.filter() — use Array.from() or for-loops
• .whose() selectors fail on child mailbox arrays — use for-loops
• Launch Mail first if not running: open -g -a "Mail"