Setup & Installation
openclaw skills install @gumadeiras/apple-mail-search-safe
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install apple-mail-search-safe
Version History
v5.0.4Feb 18, 2026 - Version note by skill developer:
Set display title to Apple Mail Search Safe (fruitmail).
What This Skill Does
Searches Apple Mail.app on macOS using direct SQLite queries against the local mail database. Supports filtering by subject, sender, date range, and read status, plus reading full email bodies via AppleScript and opening messages in Mail.app.
SQLite queries against the local Envelope Index return results in ~50ms compared to 8+ minutes with AppleScript full iteration.
When to use it
- Finding an invoice email from last month
- Checking all unread emails from a specific domain
- Extracting email subjects into JSON for scripting
- Locating a message by sender without scrolling through Mail.app
- Reading the full body of a specific email by ID
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: find unread emails from Amazon in the last 30 days
AGENT
- 1Run `fruitmail sender "@amazon.com" --days 30 --unread` to query the SQLite database
- 2Parse the returned list of matching messages
- 3Select a message ID from the results
- 4Run `fruitmail body <id>` to fetch the full email body via AppleScript
OUTPUT
List of matching Amazon emails with full body content of the selected message