Skip to content

it will contain different utilities for GMail API over OAuth2

License

Notifications You must be signed in to change notification settings

abhishekkr/gmail-helper

Repository files navigation

gmail-helper

to allow helpful GMail tasks over OAuth2 API using Google's API Client

details on how to get credentials json are here

Capabilities

  • Permanently delete mails based on search criteria allowed by GMail such as partial match of subject, to or from e-mail address fields (also allowing just domain match). Ran for a range of years provided by config as since_year and before_year.

by default it reads mails first and stores it locally (except attachments) in a sqlite DB separated by year of mail, then deletes

How to use: python3 delete-mails.py ./config-yamls/delete-mails-config.yaml

GMail API doc: developers.google.com/gmail/api/v1/reference/users/messages/delete

result after a recent run

Google storage freed by 9%

  • Fetch created GMail Labels and persist to a local DB

How to use: python3 get-labels.py ./config-yamls/get-labels-config.yaml

  • Get all GMail filters
  • persisted in db: python3 get-labels.py ./config-yamls/get-filters-config.yaml

  • exported to json in configured dir filters_json_basepath with adding switch --to-json to above command

  • Create a new/overwrite GMail filter

ToDo

  • offline backup of mails (all/filtered) into local SQLite3 db file; not of attachments

  • send mails from a custom template to a list of receivers

  • check recent mails for a specific mail, act as desired if received


For Contributors