apple-mail

name	apple-mail
description	Read and send emails via Apple Mail (macOS). Use when the user wants to check emails, read messages, send emails, reply, or search inbox. Uses the dedicated mail tool — no exec needed.

Apple Mail (GenosOS)

Read and send emails via the dedicated mail tool. Secure — the agent declares intent, the server builds the AppleScript internally.

Actions

List recent emails

mail({ action: 'list', count: 10 })

Returns: sender, subject, date for the N most recent messages in inbox.

Read an email

mail({ action: 'read', index: 1 })

Returns: full content of the message at position N (1 = most recent).

Search emails

mail({ action: 'search', query: 'factura' })

Returns: messages matching the search term in subject or sender.

Send an email

mail({ action: 'send', to: '[e-mail]', subject: 'Hello', body: 'Message text' })

Reply to an email

mail({ action: 'reply', index: 1, body: 'Thanks for your message' })

Notes

• macOS only — requires Apple Mail configured with at least one account
• First run may trigger macOS permission prompt for automation
• The agent never writes AppleScript directly — the server builds it securely
• No exec needed — the mail tool handles everything