apple-mail-search

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

3|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/yungweng/dotfiles --skill apple-mail-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-mail-search
Source: https://github.com/yungweng/dotfiles/tree/main/claude/.claude/skills/apple-mail-search
Command: npx skills add https://github.com/yungweng/dotfiles --skill apple-mail-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you quickly locate specific emails within your Apple Mail client when you can't remember the exact sender, subject, or content.

Core Features & Use Cases

  • Direct Database Access: Queries the Apple Mail database (Envelope Index) for efficient searching.
  • Content Parsing: Can parse EMLX files for full email bodies when needed.
  • Advanced Search: Supports searching by sender (name and address), subject, body content, recipient, domain, and date range.
  • Use Case: You need to find an email from "John Doe" about the "Q3 Project Update" that you received last week. This Skill can efficiently search your inbox for these criteria.

Quick Start

Search for emails from 'John Doe' with 'Q3 Project Update' in the subject.

Frequently Asked Questions about apple-mail-search

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

FAQPage Schema
How do I search Apple Mail emails by sender and subject?

To search Apple Mail emails, query the Envelope Index database and parse EMLX files to find specific messages by sender, subject, recipient, domain, body content, or date range.

Can I find old emails in EMLX files without opening Apple Mail?

Yes, you can find emails in EMLX files by parsing them directly for full content retrieval, bypassing the need to manually open and search within the Apple Mail client interface.

Does Apple Mail search support filtering by sender domain and date range?

Apple Mail search supports advanced filtering by sender domain, recipient, body content, and specific date ranges using SQLite database lookups on the Envelope Index.

How does searching the Apple Mail database compare to standard client search?

Searching the Apple Mail database directly via SQLite provides efficient lookups and EMLX parsing for full content retrieval, offering faster and more precise results than standard client searches.

What is the best way to locate a specific email when I forgot the sender?

The best way to locate an email when you forgot the sender is to search by body content, subject, recipient, or sender domain using direct database queries on the Envelope Index.

Why does searching Apple Mail require SQLite and EMLX parsing?

Searching Apple Mail requires SQLite for efficient database lookups in the Envelope Index and EMLX parsing to retrieve the full email body content when needed.