wassupdoc/gmail-autoclean

Gmail AutoClean is a Google Apps Script tool that keeps a Gmail inbox tidy by automatically deleting old newsletters, coupons, and other recurring emails while protecting anything a user marks as important. Rather than a person manually going through hundreds or thousands of old messages, the tool learns which senders it should manage and applies rules that decide how many recent emails to keep. The tool works entirely through Gmail labels. A user tags one email from a sender with a label called AutoClean slash Learn, and after running the cleanup, the sender is added to a registry with settings such as keeping only the newest email, running in test mode first, and never touching unread mail. A separate label, AutoClean slash Keep, protects any email or thread for as long as that label stays applied, which is useful for tax receipts, warranty information, or anything else that should never be removed. Another label, AutoClean slash Ignore, tells the tool to skip a sender entirely, which suits banks, schools, friends, or family. Everything runs inside a spreadsheet that the tool creates automatically the first time it runs. That spreadsheet acts as a dashboard, showing every managed sender, how many emails were removed, how many would be removed in a test run, and links back to the relevant messages in Gmail. Cleanup can be triggered manually or scheduled to run automatically, and it processes existing inbox history as well as new mail going forward, working through large numbers of senders in batches. Installing it means either making a copy of a ready made template spreadsheet, which sets up the script automatically, or manually creating a Google Sheet, pasting the provided script files into the Apps Script editor, and granting Gmail and Sheets permissions. There is no automatic update mechanism, so updating later means replacing the script files by hand while the sender settings stay untouched in the spreadsheet. This is a very small project so far, with a single star, aimed at anyone who wants their Gmail inbox to stay clean without manually deleting old newsletters and receipts one by one.