Agent skill · software engineering · sundial-org

apple-mail-search

Fast & safe Apple Mail search with body content support.

Why this skill is useful

Adds niche commands for fast and safe searching of Apple Mail content using SQLite, which the AI wouldn't reliably generate on its own.

What it needs

Requires node installed locally. About 1k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.

What this skill does

Fruitmail (Fast & Safe) Fast SQLite-based search for Apple Mail.app with full body content support. Installation Usage Commands Command Description --------- ------------- search Complex search with filters sender <query> Search by sender email unread List unread emails body <id> Read full email body (AppleScript) open <id> Open email in Mail.app stats Database statistics Search Options Examples Performance Method Time for 130k emails -------- --------------------- AppleScript (full iteration) 8+ minutes SQLite (this tool) ~50ms Technical Details Database: ~/Library/Mail/V{9,10,11}/MailData/Envelope Index Query method: SQLite (read-only) + AppleScript (body content) Safety: Read-only mode prevents modification; optional --copy mode available Notes macOS only — queries Apple Mail.app's local database Read-only — can search/read but cannot compose/send To send emails: Use the himalaya skill (IMAP/SMTP) Source https://github.com/gumadeiras/apple-mail-search-cli

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills sundial-org/apple-mail-search

View the source on GitHub

Browse the @skills marketplace