Skip to content
TakoAPI
Back to skills

apple-mail-search-safe

by gumadeiras

Communication
3.3kDownloads reported by clawskills.sh
3Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Fast & safe Apple Mail search with body.

Description

What This Skill Does

Searches Apple Mail.app on macOS using direct SQLite queries against the local mail database. Supports filtering by subject, sender, date range, and read status, plus reading full email bodies via AppleScript and opening messages in Mail.app.

SQLite queries against the local Envelope Index return results in ~50ms compared to 8+ minutes with AppleScript full iteration.

When to Use It

  • Finding an invoice email from last month
  • Checking all unread emails from a specific domain
  • Extracting email subjects into JSON for scripting
  • Locating a message by sender without scrolling through Mail.app
  • Reading the full body of a specific email by ID

Example Workflow

INPUT

User asks: find unread emails from Amazon in the last 30 days

AGENT
  1. 1

    Run fruitmail sender "@amazon.com" --days 30 --unread to query the SQLite database

  2. 2

    Parse the returned list of matching messages

  3. 3

    Select a message ID from the results

  4. 4

    Run fruitmail body <id> to fetch the full email body via AppleScript

OUTPUT

List of matching Amazon emails with full body content of the selected message

Installation

clawhub install gumadeiras/apple-mail-search-safe

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links