temp-mails

What it is and what it does

temp-mails is a wrapper library that unifies access to temporary email services across multiple providers. Instead of learning separate APIs for each disposable email site, you instantiate a provider class (e.g., Tenminemail_com, Byom_de) and call consistent methods like get_inbox(), wait_for_new_email(), and get_mail_content() to manage temporary inboxes.

The library supports around 76 different temp mail sites. It handles HTTP requests, HTML parsing, and WebSocket communication needed to interact with each provider's backend. Error handling is minimal by design—the library assumes that if something breaks, it's due to a third-party site change and cannot be recovered automatically. This makes it suitable for scripted account registration and email verification workflows where you control the flow and can retry or switch providers if needed.

Use it for:

• Automated account registration and email verification testing where you need a fresh inbox for each test run
• Bulk user signup testing across multiple services to verify email confirmation workflows
• Temporary email collection for services requiring email verification without exposing a permanent address
• Integration testing of email-dependent features in CI/CD pipelines using disposable addresses
• Switching between multiple temp mail providers in a single script if one provider becomes unavailable

Worth the install?

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

Provides a unified Python API to generate temporary email addresses and retrieve messages from multiple disposable email services, abstracting away the differences between individual provider implementations.

Yes, if you need to automate temporary email workflows and can tolerate maintenance risk. The library is permissively licensed, has no external dependencies, and covers a broad range of providers. However, it depends entirely on third-party sites remaining accessible and unchanged. The aging maintenance status and minimal error handling mean you should expect to debug provider-specific failures yourself.

Install

temp-mails on PyPI

pip install temp-mails

uv add temp-mails

poetry add temp-mails

Installing temp-mails

Before you install

Low install friction with no runtime dependencies. Maintenance is aging—last commit was 2025-05-19 with 51 stars, suggesting modest adoption and limited active development.

License in practice

Licensed under MIT (permissive), so you can use, modify, and distribute the package freely with minimal restrictions.

Quickstart

pip install temp-mails

from temp_mails import Tenminemail_com

mail = Tenminemail_com()
print(mail.email)
print(mail.get_inbox())
data = mail.wait_for_new_email(timeout=120)
if data:
    print(mail.get_mail_content(message_id=data["id"]))

Requires Python >=3.8; websocket-client==1.7.0 may conflict with other websocket packages—you may need to uninstall conflicting versions first.

Verify before relying

• Whether all supported providers remain functional given dependence on third-party sites that may change or block access
• Performance and reliability when handling high-volume email polling across different providers
• Whether websocket-client==1.7.0 remains compatible with current Python versions and other installed packages

Package facts

Evidence: temp_mails-2.2.0-py3-none-any.whl

Tags

More WWW/HTTP packages