Skip to content

Extracts bounced email addresses from unread Gmail messages labeled "Bounced" using the Gmail API. Outputs results to Excel for list hygiene and bounce tracking.

Notifications You must be signed in to change notification settings

tamtural/gmail_bounced_email_parser

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 

Repository files navigation

Gmail Bounced Email Parser

This Python script connects to your Gmail inbox, scans unread messages labeled "Bounced", extracts failed recipient email addresses from bounce notifications, and exports them into Excel files in batch format.

Features

  • OAuth 2.0 Gmail API authentication
  • Searches unread emails by label
  • Regex-powered extraction of bounced addresses
  • Batch processing with pagination
  • Automatically marks emails as read after parsing
  • Outputs clean Excel files (.xlsx) by batch

Dependencies

Install these packages before running the script:

pip install google-auth google-auth-oauthlib google-auth-httplib2 google-api-python-client pandas openpyxl

## Author
Created by [Tamarl Christie](https://github.com/tamtural) to automate and streamline premium file auditing as part of a larger billing reconciliation pipeline.

About

Extracts bounced email addresses from unread Gmail messages labeled "Bounced" using the Gmail API. Outputs results to Excel for list hygiene and bounce tracking.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages