Search and extract Apple Mail messages and attachments read-only from local macOS data.
npx skills add https://github.com/gmcabrita/dotfiles --skill apple-mail-gmcabrita
Please help me install this Agent Skill. Skill: apple-mail Source: https://github.com/gmcabrita/dotfiles/tree/main/.agents/skills/apple-mail Command: npx skills add https://github.com/gmcabrita/dotfiles --skill apple-mail-gmcabrita
Apple Mail stores messages and attachments in local data stores that are not easily queried without specialized tooling. This Skill provides a read-only mechanism to search and inspect messages, read raw RFC822 content, and extract attachments for offline analysis or migration.
Run the tool to search Apple Mail messages (eg, apple-mail.sh search --from "[email protected]"), then inspect or extract attachments with info or attachment commands.
High-intent search queries and answers about installing and using this skill.
You can search Apple Mail messages locally by querying the Envelope Index and .emlx files. This Skill operates strictly in read-only mode, allowing you to find messages by sender, subject, body, date, mailbox, and flags without modifying original data.
Yes, you can extract attachments from .emlx files into a temporary directory. This Skill preserves the original message data while exporting attachments, supporting offline analysis, data migration, or forensic workflows.
Yes, sqlite3 is a required dependency to query the Apple Mail envelope index. It enables the Skill to retrieve message metadata, mailbox information, and search results from your local macOS mail data store.
You can inspect raw RFC822 content by using the read command on local .emlx files. This allows you to view full message headers and bodies directly, which is useful for forensic inspection and detailed email analysis.
To migrate Apple Mail data, use this Skill to search local Envelope Index records and extract raw RFC822 messages with attachments. This read-only approach ensures your original local mail store remains intact while providing data for conversion.
The primary limitation is that this Skill operates exclusively in read-only mode and relies on the latest local Apple Mail envelope index. It cannot modify emails, send messages, or access data not synchronized to your local macOS mail store.
yjwongRead and search Lark Mail emails via IMAP with a local cache.
bivexExtract and structure game achievement entities from narrative text.
gumadeirasSearch Apple Mail envelope metadata with SQLite and fetch message bodies via AppleScript.
jdrodriguezParse .eml, .msg, and .mbox files into structured records with threading and deduplication.
