Python IMAP OAuth2 Gmail Authenticator Helper
This project helps to setup Google OAuth2 authentication for IMAP connection with Gmail.
If you want to read emails from Gmail in your automated E2E tests or scripts, you're in a right place!
This project is built to guide you through the process. Pyioga is an additional layer built on Google authentication libraries to make it easy.
- Go to GCP Credentials page
- Create credentials -> OAuth Client ID -> Web Application
- Add authorized redirect URI "http://localhost/" (trailing slash is important!)
- Download credentials json file (client secrets)
Install package using pip
pip install pyioga
Generate token file, based on downloaded client secrets file. During this step a web browser is going to pop up with request for permissions.
pyioga init --client-secret-file <path to client secrets file> --output-file <path e.g. token.json>
Having token file, you are ready to go!
Assuming you went through installation and you have token file (also known as "authorized user file") you can use it to authenticate IMAP connections, using pyioga's functions.
Example with Python's builtin library imaplib
import imaplib
import pyioga
username = "[email protected]"
access_token = pyioga.get_access_token("token.json")
client = imaplib.IMAP4_SSL(host="imap.gmail.com")
client.authenticate("XOAUTH2", authobject=lambda x: pyioga.get_auth_string(username, access_token))
# ('OK', [b'[email protected] authenticated (Success)'])Example with imap-tools
import pyioga
from imap_tools import MailBox, AND
username = "[email protected]"
access_token = pyioga.get_access_token("token.json")
with MailBox('imap.gmail.com').xoauth2(username, access_token) as mailbox:
for msg in mailbox.fetch():
print(msg.date, msg.subject, len(msg.text or msg.html))pyioga.get_access_token is ensuring you will receive a valid token - otherwise it should raise an exception.