Skip to main content
  1. Posts/

Keep Your Inbox Clutter-Free: Automate Email Deletion in Gmail

·820 words·4 mins· loading · loading · ·
tech tips email
Content Creator & Founder @ Wayfinder
Table of Contents
  • Image Credits: Images were created using Midjourney.

  • Explore More: Visit our Linktree for resources and social updates.

  • Support Us: As an Amazon Affiliate, we earn from qualifying purchases at no extra cost to you. Listen to the “ Managing Time by Managing Email” audiobook by Jeff Davidson for FREE.

  • Stay Updated: Subscribe to our newsletter for more curated health, wealth, and relationships content.



Do you ever find your Gmail inbox cluttered with emails that are only relevant for a short period? Think about those balance notifications from a highly fluctuating account, up-to-the-minute stock quotes, or short-lived discount offers. These messages are essential momentarily but quickly lose their value. Wouldn’t it be great if these emails could just vanish on their own after serving their purpose? Well, with a simple Google Apps Script, you can automate this process and keep your inbox streamlined. Here’s how you can set it up, even with just a basic level of IT know-how.

Step 1: Open Google Apps Script

Navigate to Google Apps Script and log in with your Google account. Then, start a new project by clicking New Project.

Step 2: Paste the Script

In the script editor (a blank file named, paste the following script:

function deleteEmails() {
  var label = GmailApp.getUserLabelByName("YourLabelHere"); // Replace 'YourLabelHere' with your label name
  var interval = 5; // Interval in minutes
  var date = new Date();
  var timeToCheck = date.getTime() - 1000 * 60 * interval; // Calculate 5 minutes ago
  var threads = label.getThreads();

  for (var i = 0; i < threads.length; i++) {
    if (threads[i].getLastMessageDate().getTime() < timeToCheck) {

Step 3: Customize the Script

Modify the script by replacing 'YourLabelHere' with the name of the Gmail label you want to target.

Step 4: Set Up a Trigger


Create an automatic trigger for the script:

  • Click the clock icon on the left sidebar to open Triggers.
  • At the bottom right corner, click Add Trigger.
  • Select the deleteEmails function.
  • Choose Time-driven, Minutes timer, and the interval as Every 5 minutes.

Step 5: Save and Authorize

Save your project. Run the script once manually for authorization – a key step for operational functionality.

Step 6: Testing

Test the script with a non-essential email labeled as specified. Wait for 5 minutes to check if it gets automatically deleted.

Final Thoughts


My use case for this script is managing GitHub Actions notifications. These alerts are crucial to know when a workflow has finished. Still, the notification content itself isn’t needed after a short period. So, I’ve set the duration for deletion at 5 minutes. This little automation keeps my inbox clean and focused, letting me stay on top of what’s important without the clutter of outdated notifications.

Remember, this script is powerful and will delete emails, so use it wisely. First, ensure you test it thoroughly with non-critical emails and remain within Google’s usage limits and policies.

Here’s to a more organized and efficient email experience! 🍷πŸ₯‚πŸŽ‰βœ¨


Q1: How can I automatically delete emails in Gmail? A1: Automate your email deletion in Gmail by using Google Apps Script. This guide provides a step-by-step process to set up a script that deletes emails based on specific labels after a set time, perfect for managing short-lived emails.

Q2: Is it possible to delete emails from a specific label in Gmail automatically? A2: Yes, you can set up Google Apps Script to automatically delete emails from a specific Gmail label. Customize the script provided in our guide to target the label of your choice.

Q2: What are some common use cases for automatically deleting Gmail emails? A3: Common use cases include managing notifications from fluctuating accounts, stock quotes, limited-time offers, and GitHub Actions notifications, which are only relevant briefly.

Q3: Is this automated email deletion process suitable for non-technical users? A4: Absolutely! Our guide is tailored for users with low to mid-level IT knowledge, making it accessible for anyone looking to streamline their email management.

Q4: How often can I set the script to check and delete emails? A5: You can customize the script to match and delete emails at various intervals. Our guide specifically shows you how to set it up for a 5-minute interval, which is ideal for very time-sensitive emails.

Q5: Is using Google Apps Script to delete emails safe? A6: Yes, it’s safe but requires cautious use. Our guide emphasizes testing the script with non-critical emails first and ensuring compliance with Google’s usage policies.

Pay It Forward 🌟

Enjoyed the article? πŸ‘πŸ’¬πŸ‘πŸ“₯
Please consider showing your appreciation by giving us a tip on Ko-fi β˜•οΈπŸŽ‰. Your support helps us keep the content flowing!

This article is also available at the An IT Guru Medium publication.

Gmail is a trademark of Google LLC. The Welcome Rain & An IT Guru publications are not affiliated with, endorsed by, or sponsored by Google LLC.



Why I Became a Friend of Medium
·1661 words·8 mins· loading · loading
medium writing side hustle
From Idea to Launch: How to Use the Lean Startup Method to Rapidly Test and Iterate Your Way to Product-Market Fit
·2936 words·14 mins· loading · loading
book review
The Last Minute Lifesaver: Why Amazon Gift Cards are Your Holiday Hero
·671 words·4 mins· loading · loading