← Back to Skills Marketplace
Apple Mail Search Safe.Bak
by
hellohushuai
· GitHub ↗
· v1.0.0
· MIT-0
187
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install apple-mail-search-safe-bak
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 to do what it says (search local Apple Mail), but take these precautions before installing: 1) Verify the upstream npm package and GitHub repo (apple-mail-search-cli / gumadeiras/fruitmail-cli) — inspect package contents and maintainers for malicious install-scripts or unexpected network calls. 2) Note the registry metadata mismatches (different ownerId/slug/version in _meta.json vs registry) — ask the publisher to confirm provenance. 3) Expect the tool to read your Mail database and run AppleScript to access message bodies — do not install if you cannot trust the package. 4) If you proceed, run with the '--copy'/'read-only' option or test in a restricted/sandboxed account, and audit network activity and the installed binary (npm ls, inspect bin files) before granting broader use.
Capability Analysis
Type: OpenClaw Skill
Name: apple-mail-search-safe-bak
Version: 1.0.0
The skill provides access to the user's local Apple Mail database (~/Library/Mail) and uses AppleScript to read full email bodies. While these capabilities are aligned with the stated purpose of searching and reading mail, they represent a high-risk access to sensitive personal data. No evidence of intentional malice, such as data exfiltration or hidden prompt injection, was found in the SKILL.md or _meta.json files.
Capability Assessment
Purpose & Capability
The skill name/description, required binary (fruitmail), and SKILL.md all consistently describe a CLI that reads Apple Mail's local Envelope Index and uses AppleScript to fetch message bodies — those capabilities match the stated purpose.
Instruction Scope
SKILL.md explicitly instructs the agent to read ~/Library/Mail/.../Envelope Index (read-only) and use AppleScript to read message bodies. Those actions are necessary for the advertised functionality but involve accessing highly sensitive personal email data; the doc recommends a safe '--copy' mode, which is appropriate.
Install Mechanism
Install is an npm global package (apple-mail-search-cli -> fruitmail). npm packages can execute arbitrary code at install/run time; the skill includes no bundled code for inspection, so you must trust the remote package. This is a moderate risk compared with instruction-only skills that do not pull code from a registry.
Credentials
The skill requests no environment variables or external credentials, which is proportional to its purpose. However, it does require filesystem access to Mail's database, which is intrinsically sensitive but expected for this functionality.
Persistence & Privilege
The skill does not request always:true, no persistent privileges or cross-skill config changes are declared, and autonomous invocation is the platform default. Nothing here elevates privileges beyond normal skill behavior.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install apple-mail-search-safe-bak - After installation, invoke the skill by name or use
/apple-mail-search-safe-bak - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of apple-mail-search-safe-bak.
- Provides fast, read-only search for Apple Mail.app using SQLite for metadata and AppleScript for full email body.
- Supports searches by subject, sender, recipient, and date with advanced filtering options.
- Enables viewing, opening, and reading full emails directly from the command line.
- Optimized performance (~50ms for 130k emails) compared to slower AppleScript-only solutions.
- Includes safety features such as optional database copy mode to ensure no modification of mail data.
Metadata
Frequently Asked Questions
What is Apple Mail Search Safe.Bak?
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 187 downloads so far.
How do I install Apple Mail Search Safe.Bak?
Run "/install apple-mail-search-safe-bak" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Apple Mail Search Safe.Bak free?
Yes, Apple Mail Search Safe.Bak is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Apple Mail Search Safe.Bak support?
Apple Mail Search Safe.Bak is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Apple Mail Search Safe.Bak?
It is built and maintained by hellohushuai (@hellohushuai); the current version is v1.0.0.
More Skills