email-normalize 3.1.0

Return a normalized email-address stripping ISP specific behaviors

email-normalize

A Python 3.11+ library for normalizing email addresses by stripping mailbox-provider-specific behaviors such as plus addressing ([e-mail]) and period ignoring ([e-mail]).

Installation

pip install email-normalize

Usage

Synchronous

import email_normalize

result = email_normalize.normalize('[e-mail]')
print(result.normalized_address)  # [e-mail]
print(result.mailbox_provider)    # Google
print(result.mx_records)          # [(5, 'gmail-smtp-in.l.google.com'), ...]

Async

For use within an asyncio application, use the Normalizer class directly:

import asyncio

import email_normalize


async def main():
    normalizer = email_normalize.Normalizer()
    result = await normalizer.normalize('[e-mail]')
    print(result.normalized_address)

asyncio.run(main())

The Normalizer maintains a LFRU cache of MX lookups, making it efficient for batch processing.

Without DNS Lookups

Use skip_dns=True to normalize against well-known domains without performing MX record lookups:

result = email_normalize.normalize('[e-mail]', skip_dns=True)

This mode uses a static domain map and will not detect providers for custom domains.

Normalization Rules

Provider	Plus Addressing	Strip Periods	Local Part as Hostname
Apple	x
Fastmail	x		x
Google	x	x*
Microsoft	x
ProtonMail	x
Rackspace	x
Yahoo
Yandex	x
Zoho	x

• Plus Addressing: Strips everything after + in the local part
• Strip Periods: Removes . from the local part
• Local Part as Hostname: Extracts the subdomain as the local part (Fastmail custom domains)

* Google strips periods only for consumer Gmail addresses (gmail.com and googlemail.com). Google Workspace custom domains route through the same MX servers but treat periods as significant, so periods are preserved for them (plus addressing is still stripped).

Documentation

Full documentation is available at gmr.github.io/email-normalize.