Setup & Installation
openclaw skills install @mneves75/apple-mail-search
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install apple-mail-search
What This Skill Does
Searches Apple Mail emails by querying the local SQLite database directly. Returns results in ~50ms across large mailboxes. Read-only, macOS only, works with Mail.app metadata.
Queries the SQLite Envelope Index directly, bypassing AppleScript iteration and Spotlight (broken since Big Sur), making large mailbox searches ~10,000x faster.
When to use it
- Find an invoice email by subject keyword
- List all unread emails as JSON for scripting
- Search emails from a specific sender domain
- Export last 30 days of emails to CSV
- Locate all emails with PDF attachments
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: find all PDF attachments from bank of america in the last 30 days
AGENT
- 1Run mail-search sender "@bankofamerica.com" -n 100 to get recent sender matches
- 2Pipe output through grep -i pdf or use mail-search attachment-type pdf separately
- 3Combine with mail-search recent 30 to narrow date range
- 4Format results with --json flag for structured output
OUTPUT
List of matching emails with subject, date, and attachment metadata