Cull Mail

Your email runs itself. You show up for what matters.

A native macOS Gmail client that groups emails by sender domain, lets you archive in bulk, and saves you hours — all without reading your emails.

View Website | Watch Demo

• Group by Domain — See all emails from a sender at once. Newsletters, promotions, notifications — instantly organized.
• Bulk Archive — Archive all emails from a domain with one click. Clear years of newsletters in seconds.
• Gmail Search — Full Gmail search syntax. Find old emails, filter by date, attachments, or any query.
• Conversation View — See threads as conversations. Expand and collapse naturally.
• Privacy First — All processing on your Mac. Your emails never touch external servers.
• Native Performance — Built with SwiftUI. Fast, lightweight, native macOS experience.

Coming soon

Download the latest release from the Releases page.

Requirements:

• Xcode 15+
• macOS 14+

# Clone the repository
git clone https://github.com/vipink1/CullMail.git
cd CullMail

# Create Secrets.swift with your Google OAuth credentials
cat > CullMail/Services/Secrets.swift << 'EOF'
import Foundation

enum Secrets {
    static let googleClientId = "YOUR_CLIENT_ID.apps.googleusercontent.com"
    static let googleClientSecret = "YOUR_CLIENT_SECRET"
}
EOF

# Open in Xcode
open CullMail.xcodeproj

# Build and run (Cmd+R)

1. Go to Google Cloud Console
2. Create a new project or select an existing one
3. Enable the Gmail API and Google Drive API
4. Create OAuth 2.0 credentials (Desktop app type)
5. Copy the Client ID and Client Secret to Secrets.swift

1. Sign In — Authenticate with your Gmail account using OAuth2
2. Sync — The app automatically syncs your emails in the background
3. Browse Senders — View all your email senders grouped by domain
4. Take Action — Archive all, mark read/unread, or view emails from any sender
5. Search Gmail — Use Gmail's powerful search syntax to find specific emails

• Local Processing — All email processing happens on your Mac
• No External Servers — Your email content is never sent anywhere except Gmail
• Secure Auth — OAuth 2.0 for Gmail access, tokens stored in Keychain
• No Tracking — No analytics, no telemetry, no data collection

CullMail/
├── CullMail/           # Main macOS app
│   ├── Views/          # SwiftUI views
│   ├── Services/       # Gmail, Auth, Sync services
│   └── Resources/      # Assets, Info.plist
├── CullKit/            # Shared framework
│   ├── Models/         # Email, Sender, etc.
│   ├── Stores/         # Reactive data stores
│   ├── Database/       # GRDB repositories
│   └── Utils/          # Utilities
└── docs/               # GitHub Pages site

Contributions welcome! Please feel free to submit a Pull Request.

MIT License - see LICENSE for details.

• GRDB — SQLite toolkit for Swift
• Gmail API — Google's email API

Made by Vipin