mailflow 0.1.0

Async email sending, receiving, and parsing for Python applications.

mailflow

Async email for Python.

Send, receive, and parse email with one simple async interface.

Install

pip install mailflow

Requires Python 3.12+.

Why mailflow?

• Send and receive email with one async client
• Works with Gmail and standard SMTP/IMAP providers
• Parse MIME messages into easy-to-use objects
• Handle replies with built-in helpers

from mailflow import EmailAccount, MailClient, OutboundEmail, SearchCriteria


async def main() -> None:
    account = EmailAccount.gmail("[e-mail]", password="app-password")

    async with MailClient(account) as client:
        messages = await client.fetch(SearchCriteria(unseen=True, limit=10))
        for message in messages:
            await client.reply(message, "Thanks, we are looking into this.")

        await client.send(
            OutboundEmail(
                subject="Welcome",
                text="Thanks for contacting support.",
                to=["[e-mail]"],
            )
        )