zewang0217/skill-construction/apple-mail-search-safe

Claude Code and agent skill by zewang0217/skill-construction

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Fast & safe Apple Mail search with body content support.

Install

npx vskill@latest install zewang0217/skill-construction/apple-mail-search-safe

SKILL.md

The same SKILL.md was published earlier as lxyeternal/malskillbench/apple-mail-search-safe.

Fruitmail (Fast & Safe)

Fast SQLite-based search for Apple Mail.app with full body content support.

Installation

bash
npm install -g apple-mail-search-cli

Usage

bash
# 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

CommandDescription
searchComplex search with filters
sender <query>Search by sender email
unreadList unread emails
body <id>Read full email body (AppleScript)
open <id>Open email in Mail.app
statsDatabase statistics

Search Options

--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)

Examples

bash
# 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

MethodTime 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 --copy mode 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 himalaya skill (IMAP/SMTP)

Source

https://github.com/gumadeiras/apple-mail-search-cli

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/zewang0217/skill-construction/apple-mail-search-safe/badge)](https://verified-skill.com/skills/zewang0217/skill-construction/apple-mail-search-safe)

Something wrong with this skill or its page? Tell us.