Inbox Cleaner

A modern web application that helps you clean up your Microsoft Outlook inbox by showing message counts by sender and allowing you to delete messages in bulk. Built with React and Microsoft Graph API.

Features

• 🔍 View message counts by sender
• 📅 Sort by email address, message count, or last received date
• 📧 View email subjects with dates
• 🗑️ Select multiple senders for bulk deletion
• 📋 Copy email addresses to clipboard
• ⛔ Block/unblock senders
• ⏱️ Progress tracking for deletion operations
• 🛑 Stop deletion process at any time
• 📊 Total message count display

Prerequisites

• Node.js 14+ and npm
• A Microsoft personal account (Hotmail/Outlook)

Setup

1. Clone the repository:

   git clone https://github.com/bsanders1979/inbox-cleaner.git
   cd inbox-cleaner

2. Install dependencies:

   cd frontend
   npm install

3. Start the development server:

   npm start

4. Open your browser and navigate to http://localhost:3000

Usage

1. Click "Sign in with Microsoft" to authenticate
2. View the list of senders and their message counts
3. Select one or more senders using:
   • Individual checkboxes
   • Click on rows
   • Shift+click to select a range
   • "Select All" checkbox in the header
4. Click "Delete Selected" to remove messages from selected senders
5. Use the "Stop" button to cancel an ongoing deletion process
6. Click on an email address to view recent email subjects
7. Use the block/unblock button to manage unwanted senders

Microsoft Graph API Permissions

The application requires the following Microsoft Graph API permissions:

• Mail.Read - To read email messages and their properties
• Mail.ReadWrite - To delete messages and manage message rules

These permissions are requested during the Microsoft authentication process.

Security

• Uses Microsoft's authentication system
• No credentials are stored
• Access can be revoked at any time through your Microsoft account settings
• Uses Microsoft's default client ID for personal accounts

Development

The application is built with:

• React
• Material-UI
• Microsoft Graph API
• Microsoft Authentication Library (MSAL)

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Microsoft Graph API for providing the email management capabilities
• Material-UI for the beautiful and responsive components
• React team for the amazing framework