mail-newsletter

Identify newsletters in Apple Mail data and surface per-sender volume.

5|Updated Feb 28, 2026

Search Tags:#email #unsubscribe #subscription-management #apple-mail #newsletter audit #mail-analytics

Ready to run

npx skills add https://github.com/aashari/ai-agent-skills --skill mail-newsletter

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: mail-newsletter
Source: https://github.com/aashari/ai-agent-skills/tree/main/skills/apple-mail/mail-newsletter
Command: npx skills add https://github.com/aashari/ai-agent-skills --skill mail-newsletter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify newsletters and mailing lists in email data, show volume per sender, and help clean up subscriptions. Use when user wants to see what newsletters they're subscribed to, audit mailing lists, or identify email noise.

Core Features & Use Cases

Detect newsletters by unsubscribe_type and group by sender to surface volume and engagement metrics.
Surface opt-out options by locating unsubscribe links within message bodies for high-volume senders.
Provide a concise noise assessment and recommendations to reduce inbox clutter through unsubscribe actions.

Quick Start

Run a 90-day Mail.app newsletter audit to surface unsubscribe options and identify high-volume senders.

Frequently Asked Questions about mail-newsletter

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

FAQPage Schema

How do I audit newsletters and identify high-volume senders in Apple Mail?▼

To audit newsletters in Apple Mail, this Skill queries the local sqlite3 Envelope Index to group senders, compute email volume, and measure read rates within a specified time window. It surfaces per-sender counts to identify mailing list noise.

How can I find unsubscribe links for mailing lists cluttering my inbox?▼

Finding unsubscribe links for mailing lists is done by scanning message bodies to locate opt-out URLs. The Skill prioritizes high-volume senders detected during the inbox audit, providing actionable unsubscribe options to reduce clutter.

Does this newsletter audit work with email clients other than Apple Mail?▼

This newsletter audit specifically uses sqlite3 queries against the Apple Mail Envelope Index. It is designed exclusively for the Apple Mail ecosystem and does not support other email clients or platforms.

What is the best way to measure read rates for subscription emails?▼

Measuring read rates for subscription emails involves grouping messages by sender and comparing read metrics against total volume. By analyzing the Apple Mail Envelope Index, the Skill calculates engagement metrics to assess actual newsletter value.

Can I limit the newsletter audit to a specific time period like 90 days?▼

You can limit the newsletter audit to a specific time period such as 90 days by defining a time window parameter. The Skill filters the sqlite3 Envelope Index queries to only include senders and volume metrics from within that duration.

Why does my inbox have so much noise from mailing list subscriptions?▼

Inbox noise from mailing list subscriptions accumulates when high-volume senders deliver content that remains unread. The Skill detects these senders by grouping email counts and evaluating read rates to recommend targeted unsubscribe actions.