azure-simple-email 0.3.0

This is an alpha library to send email using Microsoft Graph API, a Microsoft 365 account is required to use this library

azure-simple-email

A lightweight Python library for sending email through Microsoft Azure using the Microsoft Graph API.

It wraps the OAuth2 client-credentials flow (via MSAL) and the Graph sendMail endpoint into a simple, reusable class — no boilerplate required.

Features

• Plain-text and HTML emails
• Multiple To / CC / BCC recipients
• File attachments (from disk or in-memory bytes)
• Reply-To header support
• Token caching — send multiple emails without re-authenticating
• Debug mode to redirect all outgoing mail to a test address

Installation

pip install azure-simple-email

Quick start

from azure_simple_email import AzureSendMail

mailer = AzureSendMail(user_id="[e-mail]")
mailer.add_recipient("[e-mail]")
mailer.send_email(subject="Hello", text="Hi Alice!")

Configuration

The library reads credentials from three environment variables:

Variable	Description
AZURE_EMAIL_CLIENT_ID	Azure AD application (client) ID
AZURE_EMAIL_CLIENT_SECRET	Azure AD client secret
AZURE_EMAIL_CLIENT_AUTHORITY	Authority URL, e.g. https://login.microsoftonline.com/<tenant-id>

You can set them in a .env file and load it with python-dotenv, or export them directly in your shell.

Setting up the Azure app registration

1. Go to Azure portal → Azure Active Directory → App registrations → New registration.
2. Under API permissions, add Microsoft Graph → Application permissions → Mail.Send.
3. Click Grant admin consent.
4. Under Certificates & secrets, create a client secret and copy its value.

Usage examples

HTML email with attachment

from azure_simple_email import AzureSendMail

mailer = AzureSendMail(user_id="[e-mail]")
mailer.add_recipient("[e-mail]")
mailer.add_attachment("/path/to/report.pdf")
mailer.send_email(
    subject="Monthly report",
    text="<h1>Report</h1><p>Please find the report attached.</p>",
    content_type="HTML",
)

Multiple recipients with CC and BCC

mailer = AzureSendMail(user_id="[e-mail]")
mailer.add_recipient("[e-mail]")
mailer.add_cc_recipient("[e-mail]")
mailer.add_bcc_recipient("[e-mail]")
mailer.send_email(subject="Update", text="Quarterly update.")

Sending multiple emails (token reuse)

mailer = AzureSendMail(user_id="[e-mail]")

for address in ["[e-mail]", "[e-mail]"]:
    mailer.add_recipient(address)
    mailer.send_email(subject="Newsletter", text="Hello!")
    mailer.clear()  # resets recipients/attachments, keeps the token

See the full documentation and the examples/ directory for more.

Building the documentation locally

pip install -r docs/requirements.txt
sphinx-build -b html docs/ docs/_build/html

Then open docs/_build/html/index.html in your browser.

License

MIT — see LICENSE.