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.