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.
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python >=3.8; websocket-client==1.7.0 may conflict with other websocket packages—you may need to uninstall conflicting versions first.
- 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 · maintenance · safety
permissive license (permissive) — Licensed under MIT (permissive), so you can use, modify, and distribute the package freely with minimal restrictions.
last release 2025-05-19 (452 days) · last repo commit 2025-05-19 · 51 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 95,918 downloads/mo, #13,244 on PyPI
Alternatives
Verify before relying
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"]))- 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
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 on it.
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
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.
Requires Python >=3.8; websocket-client==1.7.0 may conflict with other websocket packages—you may need to uninstall conflicting versions first.
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"]))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 | permissive license permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Aging 452 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 95,918 / month, #13,244 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3 |
Evidence: temp_mails-2.2.0-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 › “temporary email api wrapper”
- temp-mailsProvides a unified Python API to generate temporary email addresses…
- mailcheckerValidates email addresses against format rules and checks whether…
- 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 WWW/HTTP packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
HTTPX is a fully featured HTTP client library for Python that provides both sync and async APIs, with support for HTTP/1.1 and HTTP/2, plus an integrated command-line client.
Install it if you are building new projects or modernizing existing ones that rely on HTTP.
A minimal low-level HTTP client library that sends HTTP requests with thread-safe and task-safe connection pooling, supporting HTTP/1.1, HTTP/2, proxies, and both sync and async interfaces.
aiohttp is an async HTTP client and server framework built on asyncio, supporting both WebSockets and middleware-based routing for building concurrent web applications.
Install it if you need async HTTP client or server capabilities in asyncio-based applications.
See also mailslurp-client · django-templated-mail · redmail · django-post_office · mailtrap · email-validator · shortzy · disposable-email-domains · Flask-Mail · django-ses