Bulk delete Gmail messages

Ever needed to permanently delete 1000+ Gmail messages? It's a real pain, using the web interface!

This tiny Nodejs script lets you bulk delete messages by search query with ease, using the Gmail API.

How to use

Clone this repo and run yarn (or npm install).
Go to https://developers.google.com/gmail/api/quickstart/nodejs#step_1_turn_on_the, click the "Enable Gmail API"-button and download the credentials.json file into the repo's root directory.
Open a terminal, navigate to the repo and type node . --query="has:attachment larger:5M"

has:attachment larger:5M - Delete all emails with attachments larger than 5 Mb
older_than:1y is:unread - Delete all unread emails which are older than 1 year
before:2015/01/01 - Delete all emails received before 1st Jan 2015
label:promotions is:unread -google - Delete all unread emails labeled with "Promotions", if they don't contain the keyword "google"
from:notifications@facebookmail.com - Delete all Facebook notifications
in:trash - Delete all emails in trash

Here's a complete list of available Gmail search operators: https://support.google.com/mail/answer/7190?hl=en

I wrote this for private use soley, to clean up my 10 year old Gmail inbox faster. No warranty, no support. Feel free to use.