This repo is wrapper library for Gmail API interactions. Additionally it includes scripts used for my personal assistant bot (on Linux via orchestration of cron jobs). It organizes mailboxes in a give gmail account based on defined rules.
This repository is a collection of scripts to utilize wrapper functions in python. This module/library is developed as a wrapper for Gmail API. Gmail API uses get/post requests using Http protocol and transfer data with json objects as usual. Personally I developed this simple wrapper and wrote scripts around it in order to clutter my personal mailbox. I needed this to arrange my Glassdoor, LinkedIn open position notifications into their own folder from Inbox by inserting/removing Labels.
All wrapper functions are in gmail_bot_functions.py file. Simply with from gmail_bot_functions import [FunctionName] you can start. Currently I develop regular automations for my mailbox by writing new .py files. Those are named as descriptive as possible. Since this project aims for "code to learn", I would be super happy, if you could help me by sending issues, development suggestions, pull requests, beautifying the README, etc. Really, anything is appreciated.
- (Optional) Install Juypter Notebook for exploring the codebase with explore.pynb
- Enable Gmail API for your gmail account to make it accessible via bot.
- Create your own app and generate credential.json (you might have to design an authorization page). All detailed steps are in Gmail API Quickstart Guide
- Install Google Client Library:
pip install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib
- start using scripts, e.g.:
python3 remove_older_than.py [Months] [LabelName] ## retrieves all mails with label [LabelName] and moves mails older than [Months] months to Trash
As I mentioned above, please collaborate. Community always helped me to learn and improve. Even though this is not a very organized project, I am very open to any feedback, suggestions or mentoring.
Contributors names and contact info:
Umut Alihan Dikel @umutalihan