mailosaur
The Mailosaur Python library lets you integrate email and SMS testing into your continuous integration process.
Decision gist · record as of 2026-08-14
Yes. Mailosaur is actively maintained, has no known vulnerabilities, and solves a real problem in testing transactional email and SMS flows. Install it if you need to automate email or SMS verification in your test suite. The permissive MIT license and low dependency footprint make it a low-risk addition. The main condition is that you need a Mailosaur account and API key to use it.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires MAILOSAUR_API_KEY environment variable to be set; a Mailosaur account and API key must be obtained from mailosaur.com.
- Low friction installation with three lightweight runtime dependencies (python-dateutil, tzlocal, requests).
- The package is actively maintained with a recent release and no known vulnerabilities.
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.
last release 2026-05-27 (79 days) · last repo commit 2026-06-05 · 9 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 127,015 downloads/mo, #11,756 on PyPI
Alternatives
Verify before relying
pip install mailosaur
from mailosaur import MailosaurClient
from mailosaur.models import SearchCriteria
mailosaur = MailosaurClient()
criteria = SearchCriteria()
criteria.sent_to = "test@abc123.mailosaur.net"
email = mailosaur.messages.get("abc123", criteria)
print(email.subject)- Whether the library fully supports modern Python versions beyond those explicitly listed in classifiers (3.7+).
- Performance characteristics when handling large volumes of messages or attachments.
- Whether SMS testing requires additional setup beyond API key configuration.
What it is and what it does
Mailosaur is a Python client for the Mailosaur email and SMS testing service. It provides a programmatic interface to retrieve, search, and inspect messages sent to test inboxes—useful for automating verification of password resets, account confirmations, MFA codes, and other transactional communications in CI/CD pipelines. The library handles both email and SMS, automatically extracting verification codes from message bodies and providing access to HTML, plain text, attachments, and hyperlinks.
The package depends on requests for HTTP communication, python-dateutil for timestamp handling, and tzlocal for timezone support. It integrates with the Mailosaur cloud service, so it requires an active account and API key. The library is designed to work with test email addresses under your Mailosaur server domain and supports searching messages by recipient, subject, and other criteria.
Use it for
- Automate testing of password-reset email flows in end-to-end test suites.
- Extract and validate one-time passcodes from SMS or email during account verification tests.
- Verify that transactional emails are correctly formatted and contain expected content.
- Test email delivery and content in staging environments without sending to real addresses.
- Validate HTML and plain-text email rendering as part of continuous integration.
- Test multi-factor authentication flows that rely on email or SMS delivery.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
Mailosaur is actively maintained, has no known vulnerabilities, and solves a real problem in testing transactional email and SMS flows. Install it if you need to automate email or SMS verification in your test suite. The permissive MIT license and low dependency footprint make it a low-risk addition. The main condition is that you need a Mailosaur account and API key to use it.
Install
mailosaur on PyPI
Before you install
Low friction installation with three lightweight runtime dependencies (python-dateutil, tzlocal, requests). The package is actively maintained with a recent release and no known vulnerabilities.
Requires MAILOSAUR_API_KEY environment variable to be set; a Mailosaur account and API key must be obtained from mailosaur.com.
License in practice
MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.
Quickstart
pip install mailosaur
from mailosaur import MailosaurClient
from mailosaur.models import SearchCriteria
mailosaur = MailosaurClient()
criteria = SearchCriteria()
criteria.sent_to = "test@abc123.mailosaur.net"
email = mailosaur.messages.get("abc123", criteria)
print(email.subject)Verify before relying
- Whether the library fully supports modern Python versions beyond those explicitly listed in classifiers (3.7+).
- Performance characteristics when handling large volumes of messages or attachments.
- Whether SMS testing requires additional setup beyond API key configuration.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release !=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,>=2.7 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagespython-dateutiltzlocalrequests |
| Maintenance | Actively maintained 79 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 127,015 / month, #11,756 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 2Programming Language :: Python :: 2.7Programming Language :: Python :: 3Programming Language :: Python :: 3.4Programming Language :: Python :: 3.5Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: Implementation :: PyPyTopic :: Software Development :: Libraries :: Python ModulesTopic :: Software Development :: Quality AssuranceTopic :: Software Development :: Testing |
Evidence: mailosaur-8.1.1-py2.py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “email testing automation”
- mailosaurMailosaur is a Python client library for automating email and SMS…
- robotframework-imaplibrary2A Robot Framework library that connects to IMAP mailboxes to…
- mailslurp-clientMailSlurp provides a Python client for an email API service that lets…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also mailslurp-client · validate_email · imap-tools · mailsuite · emails · redmail · django-post_office · mailtrap · email-validator · aiosmtpd