skills.rest
aashari
aashariCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

mail-core

Document Apple Mail local storage layout and EMLX parsing techniques.

5|Updated Feb 28, 2026
Search Tags:#sqlite#parsing#local-data#mailbox#apple-mail#emlx
One-click install
npx skills add https://github.com/aashari/ai-agent-skills --skill mail-core
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mail-core
Source: https://github.com/aashari/ai-agent-skills/tree/main/skills/apple-mail/mail-core
Command: npx skills add https://github.com/aashari/ai-agent-skills --skill mail-core

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This technical reference provides a concise guide to how Apple Mail stores data locally on macOS, enabling agents to reason about data layout, access patterns, and parsing techniques without requiring direct code access.

Core Features & Use Cases

  • Architecture overview of Apple Mail storage under ~/Library/Mail/V10/, including the Envelope Index and per-account Mailbox directories.
  • Key tables, file layout, and data access patterns used by Apple Mail data stores to support reliable querying and debugging.
  • EMLX parsing guidance and techniques for extracting message bodies from local mail data.
  • Use cases for mail-* skills, including data layout exploration, quick diagnostics, and offline analysis of mail data.

Quick Start

Refer to this reference during a mail-* activation to understand data layout and common parsing patterns.

Frequently Asked Questions about mail-core

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

FAQPage Schema
How is Apple Mail data structured locally on macOS?▼

Apple Mail local data is structured under ~/Library/Mail/V10/ using an Envelope Index database alongside per-account Mailbox directories to organize messages. This architecture supports reliable querying and offline analysis for debugging tasks.

How do I parse EMLX files to extract message bodies from Apple Mail?▼

EMLX parsing extracts message bodies from individual files stored within local Apple Mail directories. This reference provides specific parsing techniques and guidance for accessing message content directly from macOS mail data stores.

What is the Envelope Index in Apple Mail and how does it work?▼

The Envelope Index is a SQLite database used by Apple Mail to store metadata and key tables for local messages. It enables structured data access patterns, supporting quick diagnostics and querying readiness for offline analysis.

Can I query Apple Mail local data offline using SQLite?▼

Yes, Apple Mail local data supports offline querying through its SQLite-based Envelope Index. This reference outlines key tables, file layouts, and data access patterns to support reliable querying and offline data layout exploration.

What do I need to know to debug Apple Mail local data layout issues?▼

Debugging Apple Mail local data requires understanding the storage architecture under ~/Library/Mail/V10/, including the Envelope Index and per-account Mailbox directories. This reference outlines key file paths and parsing techniques for diagnostics.

Related Skills

Explore More Software Engineering Skills→
yjwongyjwong
53

email

Read and search Lark Mail emails via IMAP with a local cache.

Community
Intermediate
yungwengyungweng
3

apple-mail-search

Search Apple Mail's Envelope Index and EMLX files by sender, subject, body, recipient, domain, and date range.

Community
Advanced
gmcabritagmcabrita
6

apple-mail

Search and extract Apple Mail messages and attachments read-only from local macOS data.

Community
Intermediate
Aayush9029Aayush9029
10

apple-mail-exporter

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

Community
Intermediate