---
id: temp-mails
version: "2.2.0"
license: unclear
license_treatment: permissive
maintenance: aging
---

# temp-mails — A basic wrapper around various temp mail sites, aiming to provide an almost identical api for every site. The main purpose of this is to provide an easy way to quickly register an account on various sites and then discard the email.

License: permissive · Maintenance: aging · Downloads: 95.9K/mo

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

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

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 95.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

temporary email api wrapper, disposable email python, temp mail provider abstraction, multi-site temp email, throwaway email service, temporary inbox management, fake email generator, email-testing, web-scraping, account-automation

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