Agent skill · operations · sundial-org
apple-mail
Apple Mail.app integration for macOS. Read inbox, search emails, send emails, reply, and manage messages with fast direct access (no enumeration).
Why this skill is useful
Adds 12 executable scripts for managing Apple Mail that provide capabilities not available through standard interfaces.
What it needs
Requires sqlite3 installed locally. About 3k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Apple Mail Interact with Mail.app via AppleScript and SQLite. Run scripts from: cd {baseDir} Commands Command Usage --------- ------- Refresh scripts/mail-refresh.sh [account] [waitseconds] List recent scripts/mail-list.sh [mailbox] [account] [limit] Search scripts/mail-search.sh "query" [mailbox] [limit] Fast search scripts/mail-fast-search.sh "query" [limit] Read email scripts/mail-read.sh <message-id> [message-id...] Delete scripts/mail-delete.sh <message-id> [message-id...] Mark read scripts/mail-mark-read.sh <message-id> [message-id...] Mark unread scripts/mail-mark-unread.sh <message-id> [message-id...] Send scripts/mail-send.sh "to@email.com" "Subject" "Body" [from-account] [attachment] ¹ Reply scripts/mail-reply.sh <message-id> "body" [reply-all] List accounts scripts/mail-accounts.sh List mailboxes scripts/mail-mailboxes.sh [account] Refreshing Mail Force Mail.app to check for new messages: Smart sync detection: Script monitors database message count Returns early when sync completes (no changes for 2s) Reports new message count: Sync complete in 2s (+3 messages) Notes: Mail.app must be running (script will error if not) mail-list.sh does NOT auto-refresh — call mail-refresh.sh first if you need fresh data Output Format List/search returns: ID ReadStatus Date Sender Subject ● = unread, blank = read Gmail Mailboxes ⚠️ Gmail special folders need [Gmail]/ prefix: Shows as Use ---------- ----- Spam [Gmail]/Spam Sent Mail [Gmail]/Sent Mail All Mail [Gmail]/All Mail Trash [Gmail]/Trash Custom labels work without prefix. Fast Search (SQLite) ✨ Now safe even if Mail.app is running — copies database to temp file first. Previously required Mail.app to be quit. Now works anytime by copying the database to a temp file before querying. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/apple-mail