MacuseMacuse
Toolboxes

Mail

The Mail toolbox integrates with macOS Mail, allowing AI assistants to search emails, read messages, compose replies, and manage your inbox.

Requirements

  • Permissions: Full Disk Access, Automation

Full Disk Access is required to read the Mail database. Automation is required for composing emails.

Tools

ToolDescription
mail_list_accountsList all configured email accounts
mail_list_mailboxesList mailboxes with optional account filter
mail_search_messagesSearch messages with flexible filters
mail_get_messagesGet full content by ID or signature
mail_get_attachmentExport attachment as base64-encoded data
mail_compose_messageCreate and send a new email
mail_reply_messageReply to a message
mail_forward_messageForward to new recipients
mail_update_read_stateMark as read or unread
mail_move_messageMove to a different mailbox
mail_delete_messageMove to Trash (not permanent)
mail_open_messageOpen in Mail.app via message:// URL

Attachments

Mail toolbox supports full attachment handling:

  • Search — Results include has_attachments field for quick filtering
  • Read — Messages include attachment metadata (filename, MIME type, size)
  • Export — Use mail_get_attachment to get attachment content as base64 or save to file
  • Send — Compose, reply, and forward support attachment_paths for attaching local files

Example Usage

  • "Show unread emails from today"
  • "Find emails from John about the project"
  • "Reply to the last email from my boss"
  • "Archive all newsletters"
  • "Compose an email to the team about tomorrow's meeting"

Ready-to-use prompts for email automation:

Browse all mail workflows →

Reminders

Create and manage reminders and to-do lists

Notes

Create and manage notes in Apple Notes

On this page

RequirementsToolsAttachmentsExample UsageRelated Workflows