Verified:GitHub

email-archive-cleanup

Archive or trash email batches by sender and subject criteria.

Updated May 22, 2026

Search Tags:#email management #email cleanup #inbox organization #email archiving #large inboxes

One-click install

npx skills add https://github.com/Agentic-Assets/apple-mail-mcp --skill email-archive-cleanup

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: email-archive-cleanup
Source: https://github.com/Agentic-Assets/apple-mail-mcp/tree/main/plugin/skills/email-archive-cleanup
Command: npx skills add https://github.com/Agentic-Assets/apple-mail-mcp --skill email-archive-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill solves the problem of efficiently managing large email inboxes by providing the ability to safely archive and clean up emails, reducing clutter and improving organization.

Core Features & Use Cases

Safe Email Archiving: Automate the process of archiving emails based on specified criteria, reducing inbox size and improving searchability.
Selective Cleanup: Clean up emails by moving them to trash or archive based on sender, subject, and other attributes, while respecting the human-sender screen.
Bulk Operations: Handle bulk operations on large inboxes by collecting email IDs and performing actions in batches, ensuring efficient inbox management.

Quick Start

To run a dry run of the email archive cleanup process, use the following command: email-archive-cleanup --dry_run=True --message_ids="[list of message_ids]"

Frequently Asked Questions about email-archive-cleanup

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

FAQPage Schema

How do I safely archive large volumes of emails without losing important messages?▼

Safely archiving large email inboxes involves filtering messages by sender, subject, and attributes to move them to archive or trash. A human-sender screen prevents archiving real people's emails unless confirmed as spam.

What is the best way to clean up an overflowing inbox using batch operations?▼

Inbox cleanup via batch operations collects email IDs and processes actions in groups. This bulk method efficiently reduces large inbox sizes while maintaining organization and improving searchability.

Can I run a dry run before permanently deleting or moving emails to the archive?▼

Yes, you can run a dry run for email archiving using the command `email-archive-cleanup --dry_run=True --message_ids="[list of message_ids]"` to test the process safely before making permanent changes.

How does the filtering mechanism handle emails from real people during inbox cleanup?▼

The filtering mechanism respects a human-sender screen during inbox cleanup. It carefully identifies senders and avoids archiving emails from real people unless specifically confirmed as spam by the user.

When should I use selective cleanup criteria for email management?▼

Use selective cleanup criteria for email management when you need to move specific messages to trash or archive based on sender and subject. This reduces clutter while protecting legitimate communications from accidental deletion.