apple-mail

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.

SKILL.md

GitHub

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: 'user@example.com', 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