---
id: flask-mail
version: "0.10.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# Flask-Mail — Flask extension for sending email

License: permissive · Maintenance: active · Downloads: 1.6M/mo

## 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 above — 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

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

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.6M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

flask email sending, smtp integration flask, send emails from flask app, flask mail extension, email notifications flask, flask message delivery, flask-extension, email-delivery

[View on SkillFed](https://skillfed.io/packages/flask-mail) · [View on PyPI](https://pypi.org/project/flask-mail/)