← 返回 Skills 市场

Apple Mail Search Safe 5.0.4

Name: Apple Mail Search Safe 5.0.4
Author: durtydhiana

作者 DurtyDhiana · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

250

总下载

当前安装

版本数

在 OpenClaw 中安装

/install 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,...

使用说明 (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 --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/fruitmail-cli

安全使用建议

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.

功能分析

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.

能力评估

✓ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install apple-mail-search-safe-5-0-4
安装完成后，直接呼叫该 Skill 的名称或使用 /apple-mail-search-safe-5-0-4 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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.

元数据

Slug apple-mail-search-safe-5-0-4

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题