← Back to Skills Marketplace
Apple Mail Search Safe (fruitmail)
by
Gustavo Madeira Santana
· GitHub ↗
· v5.0.5
· MIT-0
5055
Downloads
4
Stars
13
Active Installs
16
Versions
Install in OpenClaw
/install apple-mail-search-safe
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,...
Usage Guidance
Install only if you are comfortable giving the fruitmail CLI and your agent access to local Apple Mail search results and full email bodies. Treat email content as private and potentially untrusted text, and review the external npm package if your environment requires supply-chain assurance.
Capability Analysis
Type: OpenClaw Skill
Name: apple-mail-search-safe
Version: 5.0.5
The apple-mail-search skill provides a legitimate interface for the 'fruitmail' CLI tool to search and read local Apple Mail databases on macOS. It uses SQLite for metadata indexing and AppleScript for retrieving message bodies, which is consistent with its stated purpose. No evidence of malicious intent, data exfiltration, or prompt injection was found in the SKILL.md or metadata files.
Capability Assessment
Purpose & Capability
The stated purpose is to search Apple Mail metadata and retrieve message bodies; the documented commands match that purpose.
Instruction Scope
The skill can expose private local email metadata and full message bodies to the agent, which is sensitive but clearly disclosed and expected for this use case.
Install Mechanism
Installation uses a global npm CLI package named fruitmail; that external package is purpose-aligned but its source is not included in the skill artifact itself.
Credentials
macOS Apple Mail database access, SQLite search, and AppleScript body retrieval are proportionate to an Apple Mail search skill.
Persistence & Privilege
The artifact shows read-only mail search/read/open commands and no background worker, persistence setup, credential capture, account mutation, deletion, or email-sending authority.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install apple-mail-search-safe - After installation, invoke the skill by name or use
/apple-mail-search-safe - Provide required inputs per the skill's parameter spec and get structured output
Version History
v5.0.5
Use renamed npm package fruitmail.
v5.0.4
Set display title to Apple Mail Search Safe (fruitmail).
v5.0.3
Update description text only.
v5.0.2
Set clean display title and keep existing description.
v5.0.1
Publish skill package with SKILL.md only.
v5.0.0
Update SKILL.md and release 5.0.0
v1.1.0
Update links and metadata for fruitmail-cli repo and latest CLI behavior fixes.
v4.0.0
Major version bump - fruitmail rewrite
v2.0.1
Remove old script, skill is just SKILL.md now
v2.0.0
Rewrite: now fruitmail CLI, npm install support
v2026.1.7
- Updated installation instructions for clarity and simplicity; now recommends creating a symlink and using `clawdhub update` for updates.
- Removed previous download, clone, and copy to PATH installation methods, focusing only on the symlink approach.
- All usage, options, and examples sections remain unchanged.
- No changes made to actual search features or technical details.
v2026.1.6
- Initial release of apple-mail-search-safe.
- Added core mail search script at scripts/mail-search.sh.
- Provides fast, safe Apple Mail search with body content support.
v2026.1.5
- Removed the README.md file from the project.
- All documentation and usage instructions are now contained solely within SKILL.md.
v2026.1.4
Updated repo link to apple-mail-search-cli
v2026.1.3
Release v2026.1.3
v3.0.0
Script hosted on GitHub. Added nice README. Updated installation instructions.
Metadata
Frequently Asked Questions
What is Apple Mail Search Safe (fruitmail)?
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 5055 downloads so far.
How do I install Apple Mail Search Safe (fruitmail)?
Run "/install apple-mail-search-safe" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Apple Mail Search Safe (fruitmail) free?
Yes, Apple Mail Search Safe (fruitmail) is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Apple Mail Search Safe (fruitmail) support?
Apple Mail Search Safe (fruitmail) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Apple Mail Search Safe (fruitmail)?
It is built and maintained by Gustavo Madeira Santana (@gumadeiras); the current version is v5.0.5.
More Skills