Apple Mail search on macOS with fast metadata and full body lookup. Use for finding messages in Mail.app by subject/sender/recipient/date, opening messages,...
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Fast SQLite-based search for Apple Mail.app with full body content support.
npm install -g apple-mail-search-cli
# Complex search fruitmail search --subject "invoice" --days 30 --unreadSearch by sender
fruitmail sender "@amazon.com"
List unread emails
fruitmail unread
Read full email body (supports --json)
fruitmail body 94695
Open in Mail.app
fruitmail open 94695
Database stats
fruitmail stats
| Command | Description |
|---|---|
| Complex search with filters |
| Search by sender email |
| List unread emails |
| Read full email body (AppleScript) |
| Open email in Mail.app |
| Database statistics |
--subject <text> Search subject lines --days <n> Last N days --unread Only unread emails --limit <n> Max results (default: 20) --json Output as JSON --copy Copy DB before query (safest mode)
# Find bank statements from last month fruitmail search --subject "statement" --days 30Get unread emails as JSON
fruitmail unread --json | jq '.[] | .subject'
Find emails from Amazon
fruitmail sender "@amazon.com" --limit 50
| Method | Time for 130k emails |
|---|---|
| AppleScript (full iteration) | 8+ minutes |
| SQLite (this tool) | ~50ms |
~/Library/Mail/V{9,10,11}/MailData/Envelope Index--copyhimalayaNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
4,600+ AI skills, agents & workflows. Install in 60 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.