Gmail doesn't want to show you the size of your emails, but does complain when your mailbox is 95% full. This project is a safe privacy-aware solution to that. You can run it on your laptop or computer and use it to delete emails you never needed. Once you are done you can close this application.
This is a web application which connects to your Gmail account and classifies your emails based on their sizes into three categories: Small, Medium, and Large. It processes the first 1000 emails, and generates a web page like this:
If you want to process fewer or more emails you can do so.
Here is a small video about the initial version of this project
-
Set up Google Cloud Project and Gmail API:
- Go to the Google Cloud Console
- Create a new project
- Enable the Gmail API
- Configure the OAuth consent screen
- Create OAuth 2.0 credentials (Web application type)
- Download the credentials and save them as
credentials.jsonin the project root
-
Install dependencies:
pip install -r requirements.txt
-
Run the application:
python app.py
-
Open your browser and navigate to
http://127.0.0.1:5000
These are explained on the web page generated, but here goes
- Small: Less than 100KB
- Medium: 100KB to 1MB
- Large: More than 1MB
The application uses OAuth 2.0 for authentication and only requests read-only access to your Gmail account.
- Added links to gmail messages
- Added the capability to choose the number of emails scanned
First version

