apple-mail-exporter

Search Apple Mail's local database by keyword, sender, or subject and export matching emails.

10|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/Aayush9029/homebrew-tap --skill apple-mail-exporter
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apple-mail-exporter
Source: https://github.com/Aayush9029/homebrew-tap/tree/main/skills/apple-mail-exporter
Command: npx skills add https://github.com/Aayush9029/homebrew-tap --skill apple-mail-exporter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Apple Mail stores messages in a local database; this Skill enables you to search and export specific emails without opening Mail.app, simplifying data retrieval and archival workflows.

Core Features & Use Cases

  • Search by keyword, sender, or subject within the local Apple Mail database.
  • Export matched messages to a directory for backup, migration, or archival.
  • Use cases include offline archiving, data migration between machines, and quick extraction for reporting.

Quick Start

Search for a keyword in the local Apple Mail database and export the matching messages to a chosen directory.

Frequently Asked Questions about apple-mail-exporter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I export Apple Mail messages locally without opening the Mail app?▼

You can export Apple Mail messages locally by searching the mail database by keyword, sender, or subject and saving matched emails to a chosen output directory without launching Mail.app.

Can I search Apple Mail emails by sender or subject for offline archiving?▼

Yes, searching Apple Mail emails by sender or subject is supported for offline archiving, allowing you to extract specific messages from the local mail database directly to a designated directory.

What is the best way to migrate mail data between machines from the Apple Mail database?▼

Migrating mail data between machines is best handled by querying the local Apple Mail database and exporting matched messages to a directory, which can then be transferred to the new machine.

Does the Apple Mail exporter support overriding the default Mail directory paths?▼

Yes, the Apple Mail exporter supports overriding default Mail directory paths, allowing you to specify custom local database locations during the search and export process.

How do I limit the number of exported emails during an Apple Mail database search?▼

You can limit exported emails by using the result limits feature, which caps the number of matched messages saved to your output directory during an Apple Mail database search.

Can I list matched Apple Mail messages without exporting them?▼

Yes, you can use the list-only mode to display matched Apple Mail messages in the local database without exporting them, providing a quick preview before committing to a full export.