Generate a real temporary inbox in one tap. Try the live demo — emails actually arrive. No sign-up, no tracking.
Open in Telegram View on GitHubA real mail.tm address is created in seconds. No forms, no captchas.
A background listener polls every 5 s and forwards new mail to you the moment it arrives.
New address: 5-min cooldown. Inbox check: 30-sec cooldown. Prevents API abuse automatically.
Your active address and token are stored in SQLite so you never lose your inbox on restart.
Each Telegram user gets their own isolated inbox. No shared state, no data leaks.
Pure Python — aiogram 3, aiosqlite, mailtm, python-dotenv. One pip install away.
Send /start to the bot on Telegram. You'll see two buttons: Get Email and Check Inbox.
Tap Get Email. The bot calls the mail.tm API, creates a fresh inbox, and replies with your new address.
Mail arrives automatically via the background listener, or tap Check Inbox to pull messages on demand.
The listener stops after 5 minutes. Tap Get Email again whenever you need a fresh address.
# 1. Clone
git clone https://github.com/bonnwest/temp-mail-telegram-bot
cd temp-mail-telegram-bot
# 2. Install deps
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt
# 3. Configure
echo "TELEGRAM_TOKEN=your_token_here" > .env
# 4. Run
python bot.pyGet your token from @BotFather — it takes under a minute.