Mailprune

Smart email cleanup tool that audits your Gmail, spots noise makers, and suggests targeted fixes.

💡 Motivation

Between high-intensity work sprints, my personal digital organization often takes a backseat. Recently, my inbox hit a breaking point with 900+ unread messages, burying important threads under a mountain of junk.

Mailprune allowed me to execute a much-needed 'digital deep clean' in record time. In a single day, I whittled my inbox down to under 100 emails and audited my subscriptions—cutting them from 140 to 100. It didn’t just clear the clutter; it fixed the source of the noise so the pileup doesn't happen again.

✨ Features

• Smart Auditing: Analyzes inbox volume, open rates, and patterns
• Targeted Cleanup: Recommends unsubscribes and filters
• Advanced Analysis: Engagement tiers, clustering, and content patterns
• AI & MCP Integration: Built-in MCP server for direct AI assistant integration
• Fast & Efficient: Parallel processing with intelligent caching

🚀 Quick Start

1. Install: See USERGUIDE.md for detailed setup
2. Set up Gmail API: Follow Google's guide, place credentials.json in data/
3. Run Assessment: uv run mailprune audit --max-emails 2000
4. AI Cleanup: Register mailprune-mcp with your AI assistant for automated cleanup guidance

📖 Usage

CLI Tools

# Audit inbox
uv run mailprune audit --max-emails 2000

# Generate report
uv run mailprune report

AI / MCP Integration

Start the MCP server to give your AI assistant (e.g., Claude Desktop, Cursor) access to your inbox analytics:

uv run mailprune-mcp

Run uv run mailprune --help for all options.