Apple Mail 搜索

通过SQLite即时搜索Apple Mail.app中的邮件。约50毫秒，而AppleScript需要8分钟以上。

安装

bash

将mail-search复制到您的PATH中

使用方法

bash
mail-search subject invoice # 搜索主题
mail-search sender @amazon.com # 按发件人邮箱搜索
mail-search from-name John # 按发件人姓名搜索
mail-search to recipient@example.com # 搜索已发送邮件
mail-search unread # 列出未读邮件
mail-search attachments # 列出带附件的邮件
mail-search attachment-type pdf # 查找PDF文件
mail-search recent 7 # 最近7天
mail-search date-range 2025-01-01 2025-01-31
mail-search open 12345 # 按ID打开邮件
mail-search stats # 数据库统计信息

选项

-n, --limit N 最大结果数（默认：20）
-j, --json 输出为JSON格式
-c, --csv 输出为CSV格式
-q, --quiet 不显示表头
--db PATH 覆盖数据库路径

示例

bash

查找上个月的银行对账单

获取未读邮件并输出为JSON以便处理

查找特定发件人的所有PDF文件

将最近邮件导出为CSV

为何存在此工具

苹果在macOS Big Sur中移除了emlx的Spotlight导入器。本工具直接查询Envelope Index SQLite数据库。

技术细节

数据库： ~/Library/Mail/V{9,10,11}/MailData/Envelope Index

关键表：

• - messages - 邮件元数据（日期、标记、外键）
• subjects - 主题行
• addresses - 邮箱地址和显示名称
• recipients - 收件人/抄送映射
• attachments - 附件文件名

限制：

• - 只读（无法撰写/发送）
• 仅元数据（正文在.emlx文件中）
• 仅支持Mail.app（不支持Outlook等）

高级：原始SQL

如需自定义查询，可直接使用sqlite3：

bash
sqlite3 -header -column ~/Library/Mail/V10/MailData/Envelope\ Index
SELECT m.ROWID, s.subject, a.address
FROM messages m
JOIN subjects s ON m.subject = s.ROWID
LEFT JOIN addresses a ON m.sender = a.ROWID
WHERE s.subject LIKE %your query%
ORDER BY m.date_sent DESC
LIMIT 20;

许可证

MIT