7.5
/ 10
1 evaluations
3.2k Downloads
Overview
Fast, read-only search over Apple Mail.app’s local SQLite Envelope Index on macOS, with support for subject/sender/date/unread filters, JSON output, opening messages in Mail.app, and fetching full email bodies via AppleScript.
Key Advantages
1.Substantially faster than AppleScript-only iteration for large mailboxes (SQLite index-based queries).
2.Read-only access to Apple Mail’s Envelope Index reduces risk of corrupting mail data.
3.Supports both metadata search (subject, sender, dates, unread) and body retrieval via AppleScript.
4.Simple, scriptable CLI interface suitable for automation (JSON output, composable with tools like jq).
5.Optional --copy mode to query a copied database for extra safety when needed.
Use Cases
- Quickly locating specific messages (e.g., invoices, bank statements, receipts) across large Apple Mail archives.
- Listing recent unread emails for custom dashboards, status scripts, or terminal workflows.
- Automating triage workflows by piping JSON output into other CLI tools for filtering, tagging, or reporting.
- Opening specific messages in Mail.app by ID from scripts, launchers, or productivity tools.
- Fetching full email bodies for local text search, note-taking, or offline processing without touching IMAP/SMTP settings.
Evaluation Scores
7.5
/ 10
Reliability
7.0
Functionality
7.5
Usability
7.5
Safety
8.0
Performance
8.8
Compatibility
6.5
Based on 1 evaluation · Latest: 3/19/2026
Download Trend
Loading...
Evaluation History (1)
7.5/103/19/2026▼
OS: linux-arm64LLM: deepseek/deepseek-v3.2
**Quick judgment:** Fruitmail is a focused, high-performance CLI tool for searching Apple Mail on macOS using the local SQLite index, best suited for power users and automation scenarios. It’s fast and non-destructive, but tightly coupled to macOS/Mail.app internals and exposes sensitive email content to whatever calls it.
**Strengths:**
- Very fast queries on large mailboxes via the existing Envelope Index (claims ~50ms on ~130k emails).
- Read-only SQLite access minimizes risk of corrupting Mail data; optional `--copy` mode adds an extra safety margin.
- Practical commands (`search`, `sender`, `unread`, `body`, `open`, `stats`) and JSON output make it easy to integrate into scripts.
**Key risks & limitations:**
- **Platform lock-in:** macOS-only and Mail.app-specific; relies on internal `Envelope Index` paths (`V{9,10,11}`), which may change or break on newer macOS releases.
- **Privacy/exfiltration risk:** While the tool itself is read-only, any agent/script using it can access and potentially exfiltrate full email content and metadata. It should only be used in trusted, local, and well-permissioned contexts.
- **AppleScript dependency:** Full body retrieval uses AppleScript, which can be slower and sometimes brittle depending on system configuration and Mail.app state.
**Recommended scenarios:**
- Local, single-user macOS environments where an agent or script needs **fast, reliable read-only access** to Apple Mail contents for search and triage.
- Integrations in productivity/automation setups (e.g., Alfred, Raycast, cron jobs) that need metadata search or to open specific messages.
- Complementing a separate sending/composing skill (like an IMAP/SMTP tool) when only local search and reading are required, not sending or mailbox mutation.
Comments (0)
No comments yet. Be the first!