Fruitmail（快速且安全）

基于 SQLite 的 Apple Mail.app 快速搜索工具，支持完整邮件正文内容检索。

安装

npm install -g apple-mail-search-cli

使用方法

# 复杂搜索
fruitmail search --subject "invoice" --days 30 --unread

# 按发件人搜索
fruitmail sender "@amazon.com"

# 列出未读邮件
fruitmail unread

# 查看完整邮件正文（支持 --json 输出）
fruitmail body 94695

# 在 Mail.app 中打开该邮件
fruitmail open 94695

# 查看数据库统计信息
fruitmail stats

命令列表

搜索选项

--subject    搜索邮件主题行
--days          最近 N 天内的邮件
--unread           仅匹配未读邮件
--limit         返回结果的最大数量（默认：20）
--json             以 JSON 格式输出结果
--copy             查询前先复制数据库（最安全模式）

示例

# 查找上个月的银行账单
fruitmail search --subject "statement" --days 30

# 将未读邮件以 JSON 格式输出，并提取主题字段
fruitmail unread --json | jq '.[] | .subject'

# 查找来自 Amazon 的邮件（最多返回 50 条）
fruitmail sender "@amazon.com" --limit 50

性能对比

技术细节

• 数据库路径：~/Library/Mail/V{9,10,11}/MailData/Envelope Index
• 查询方式：SQLite（只读） + AppleScript（用于获取正文内容）
• 安全性：默认为只读模式，防止误修改；可选启用 --copy 模式进一步保障安全

注意事项

• 仅限 macOS 平台 —— 访问的是 Apple Mail.app 的本地数据库
• 只读访问 —— 支持搜索与读取，但无法撰写或发送邮件
• 如需发送邮件：请使用 himalaya skill（基于 IMAP/SMTP）

源码地址

https://github.com/gumadeiras/fruitmail-cli