mail-contacts

Extract contact details from local Apple Mail history into a structured directory.

5|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/aashari/ai-agent-skills --skill mail-contacts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mail-contacts
Source: https://github.com/aashari/ai-agent-skills/tree/main/skills/apple-mail/mail-contacts
Command: npx skills add https://github.com/aashari/ai-agent-skills --skill mail-contacts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Extract contacts from email history to build a centralized communication directory, enabling quick lookup of email addresses, contact frequency, and relationship insights.

Core Features & Use Cases

  • Directory from history: Generate a structured contact directory from local Mail data.
  • Top contacts insights: Identify frequent correspondents and recent interactions.
  • Search by name/domain: Find contacts by person name, company, or domain for targeted outreach.

Quick Start

Query your local Apple Mail history to generate a contact directory by name, company, or domain and summarize top contacts.

Frequently Asked Questions about mail-contacts

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

FAQPage Schema
How do I extract contacts from my email history to build a directory?

Extract contacts from email history by analyzing sender and recipient addresses in your local mail data to generate a structured, centralized contact directory for quick lookup.

Can I find specific email contacts by name, company, or domain?

Yes, you can find email contacts by filtering for person name, company, or domain, allowing targeted outreach and precise lookups within your extracted mail history.

What is the best way to identify top contacts and frequent correspondents?

Identify top contacts and frequent correspondents by applying optional top contact filters to your local email history, summarizing interaction frequency and relationship insights.

Does this contact directory extraction work with local Apple Mail data?

Yes, this process queries your local Apple Mail history to surface contact details and generate a structured directory directly from existing local email data.

How do I filter recent interactions when generating an email contact list?

Filter recent interactions by applying the recent contacts option, which surfaces contact details based on the latest sender and recipient activity in your local email data.

What limitations apply when building a contact directory from local mail data?

Building a contact directory from local mail data is limited to analyzing existing sender and recipient addresses, meaning deleted emails or external server data are excluded from the results.