Flask-Mail

What it is and what it does

Flask-Mail is a Flask extension that wraps SMTP email delivery into a simple, application-integrated interface. It lets you configure mail server credentials once in your Flask config, then send emails by creating Message objects and calling mail.send(). The package handles the SMTP connection lifecycle and integrates with Flask's application context.

It depends on flask for the application framework and blinker for signal support. The extension is maintained by the Pallets Community Ecosystem (the organization behind Flask itself) and remains actively developed. It is classified as Beta but has been in use since 2010, making it a stable choice for straightforward email needs in Flask applications.

Use it for:

• Send transactional emails (password resets, account confirmations) from a Flask web application.
• Notify administrators or users of application events (errors, new signups, reports).
• Deliver bulk emails to a mailing list with per-recipient customization.
• Integrate email into Flask request handlers without managing SMTP connections directly.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Flask-Mail adds email-sending functionality to Flask applications, handling SMTP configuration and message composition through a simple API.

Yes. Flask-Mail is a lightweight, permissive-licensed extension with low install friction and active maintenance. It is the standard choice for email in Flask applications when you need straightforward SMTP integration. Install it if your Flask app needs to send emails and you prefer a simple, Flask-native API over raw SMTP.

Install

flask-mail on PyPI

pip install flask-mail

uv add flask-mail

poetry add flask-mail

Installing Flask-Mail

Before you install

Low install friction with only two runtime dependencies (flask and blinker). Actively maintained as of June 2026 with recent commits; marked Beta but part of the Pallets Community Ecosystem.

License in practice

Permissive BSD license allows commercial and private use with minimal restrictions.

Quickstart

pip install flask-mail

from flask import Flask
from flask_mail import Mail, Message

app = Flask(__name__)
app.config['MAIL_SERVER'] = 'smtp.example.com'
app.config['MAIL_PORT'] = 587
app.config['MAIL_USERNAME'] = 'user@example.com'
app.config['MAIL_PASSWORD'] = 'password'

mail = Mail(app)
msg = Message('Subject', recipients=['to@example.com'], body='Body')
mail.send(msg)

Requires a configured SMTP server (local or remote) and valid credentials; Python 3.8 or later.

Verify before relying

• Whether the package supports async/background email sending or only synchronous delivery.
• Support for email templates, attachments, or HTML rendering beyond plain text.
• Rate limiting or retry logic for failed sends.

Package facts

Evidence: flask_mail-0.10.0-py3-none-any.whl

Tags

More Dynamic Content packages