← Back to Skills Marketplace
Apple Mail Search Safe 5.0.4
by
DurtyDhiana
· GitHub ↗
· v1.0.0
· MIT-0
250
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install apple-mail-search-safe-5-0-4
Description
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,...
README (SKILL.md)
Fruitmail (Fast & Safe)
Fast SQLite-based search for Apple Mail.app with full body content support.
Installation
npm install -g apple-mail-search-cli
Usage
# Complex search
fruitmail search --subject "invoice" --days 30 --unread
# Search 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
Commands
| Command | Description |
|---|---|
search |
Complex search with filters |
sender \x3Cquery> |
Search by sender email |
unread |
List unread emails |
body \x3Cid> |
Read full email body (AppleScript) |
open \x3Cid> |
Open email in Mail.app |
stats |
Database statistics |
Search Options
--subject \x3Ctext> Search subject lines
--days \x3Cn> Last N days
--unread Only unread emails
--limit \x3Cn> Max results (default: 20)
--json Output as JSON
--copy Copy DB before query (safest mode)
Examples
# Find bank statements from last month
fruitmail search --subject "statement" --days 30
# Get unread emails as JSON
fruitmail unread --json | jq '.[] | .subject'
# Find emails from Amazon
fruitmail sender "@amazon.com" --limit 50
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
--copymode 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
himalayaskill (IMAP/SMTP)
Source
Usage Guidance
This skill appears coherent for searching Apple Mail locally. Before installing: (1) verify the npm package (apple-mail-search-cli) and the linked GitHub repo to ensure the published package matches source; (2) prefer running fruitmail with --copy to avoid touching the live Envelope Index; (3) be aware macOS may prompt for AppleScript/Accessibility/Full Disk Access to read message bodies — only grant those permissions if you trust the package; (4) note the registry metadata _meta.json ownerId differs from the skill metadata — a minor inconsistency to check on the package/publisher identity. If you aren’t on macOS or cannot verify the package source, avoid installing.
Capability Analysis
Type: OpenClaw Skill
Name: apple-mail-search-safe-5-0-4
Version: 1.0.0
The skill provides an AI agent with the capability to search and read the full contents of a user's local Apple Mail database (~/Library/Mail) using SQLite and AppleScript. While the functionality aligns with the stated purpose of the 'fruitmail' CLI tool, granting an agent automated access to entire email histories and message bodies is a high-risk capability involving sensitive personal data. No evidence of intentional malice or exfiltration was found in the provided SKILL.md or metadata.
Capability Assessment
Purpose & Capability
Name/description match the runtime instructions: the skill installs a CLI (fruitmail) and instructs the agent to run searches against the local Mail SQLite index and use AppleScript for body content. Requested binaries and referenced paths are appropriate for the stated purpose.
Instruction Scope
SKILL.md limits actions to reading Mail.app data (Envelope Index path) and optionally using AppleScript to read message bodies. It does not request unrelated files, environment variables, or external endpoints. It documents a safe --copy mode to avoid touching the live DB.
Install Mechanism
Install uses npm (apple-mail-search-cli) to create a fruitmail binary. npm installs can execute arbitrary install scripts and pull code from the registry, which is a moderate-risk but expected choice for a CLI distributed via npm. Recommend verifying the package on npm/github before installing.
Credentials
No environment variables, credentials, or unrelated config paths are requested. The skill needs access to the Mail DB and AppleScript capabilities, which are proportional to the task.
Persistence & Privilege
Skill is not marked always:true and requests no system-wide persistent privileges. Running the CLI may prompt macOS permission dialogs (AppleScript/Accessibility/Full Disk Access) — normal for this functionality.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install apple-mail-search-safe-5-0-4 - After installation, invoke the skill by name or use
/apple-mail-search-safe-5-0-4 - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of apple-mail-search skill.
- Enables fast, full-text search of Apple Mail.app on macOS by subject, sender, recipient, and date.
- Supports searching, filtering unread emails, reading full body content, and opening messages in Mail.app.
- Implements high-performance, read-only queries via SQLite and AppleScript.
- Offers command-line usage examples and safety options such as read-only and copy modes.
- Designed for local use on macOS with Apple Mail.
Metadata
Frequently Asked Questions
What is Apple Mail Search Safe 5.0.4?
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,... It is an AI Agent Skill for Claude Code / OpenClaw, with 250 downloads so far.
How do I install Apple Mail Search Safe 5.0.4?
Run "/install apple-mail-search-safe-5-0-4" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Apple Mail Search Safe 5.0.4 free?
Yes, Apple Mail Search Safe 5.0.4 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Apple Mail Search Safe 5.0.4 support?
Apple Mail Search Safe 5.0.4 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Apple Mail Search Safe 5.0.4?
It is built and maintained by DurtyDhiana (@durtydhiana); the current version is v1.0.0.
More Skills