mail-top-senders

Query local mailbox data with sqlite3 to rank top senders and analyze communication patterns.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze mailbox data to identify top email senders, reveal communication frequency, and map relationships within your email network.

Core Features & Use Cases

  • Sender ranking by message count within a defined period (default last 90 days).
  • Human vs automated filtering to separate real contacts from automated senders.
  • Domain insights to summarize senders by domain and priority.
  • Use Case: Quickly answer questions like "Who emails me the most?" or "What does my email social graph look like?"

Quick Start

Ask your AI to show the top email senders from the last 90 days based on your local mailbox data.

Frequently Asked Questions about mail-top-senders

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

FAQPage Schema
How do I identify top email senders from my local Apple Mail mailbox data?

You can analyze your local mailbox data to identify top email senders by querying the Envelope Index database with sqlite3, extracting sender counts, unread messages, and domain analytics for a specified period.

Can I filter automated senders out of my email domain analysis?

Yes, you can filter automated senders out of your email domain analysis using the human vs automated filtering option, which separates real contacts from automated senders to reveal actual communication patterns.

Does this mailbox analysis require access to a specific email database format?

Yes, this mailbox analysis requires access to a local email database, specifically the Apple Mail Envelope Index file, which it queries directly using sqlite3 to retrieve sender and domain communication data.

What is the default time period for analyzing top email senders?

The default time period for analyzing top email senders is the last 90 days, providing a recent snapshot of your email social graph and communication frequency across specified domains.

How do I summarize email senders by domain to map my communication network?

You can summarize email senders by domain to map your communication network through the domain insights feature, which aggregates sender counts and priority metrics extracted from the local mailbox database.