otp-gateway
Zero-dependency Python library for receiving OTP codes via IMAP
Install in 5 seconds
pip install otp-gateway
🔑 13 OTP Patterns
Digits, alphanumeric, multi-language extraction from email bodies
📬 30+ Platforms
GitHub, Google, Discord, OpenAI, Anthropic, AWS, Azure, and more
🔗 Link Extraction
Not just codes — verification links extracted too
📛 Alias Generation
Unique email aliases for catch-all domains
🔄 Smart Dedup
Never returns the same OTP twice
🐍 Zero Deps
Only Python stdlib. Copy and paste into any project
Quick Start
from otp_gateway import OTPGateway, OTPConfig # Configure with your IMAP credentials config = OTPConfig( imap_email="you@gmail.com", imap_password="your-app-password", domain="yourdomain.com", ) gw = OTPGateway(config) # Generate alias and wait for OTP alias = gw.generate_alias("github") # Use alias to sign up... result = gw.wait_for_otp(alias, timeout=90) print(result["value"]) # "847291"
CLI Usage
# Wait for an OTP $ otp-gateway wait github@yourdomain.com ⏳ Waiting for OTP at github@yourdomain.com... ✅ OTP found: 847291 (GitHub) # Check for recent OTPs $ otp-gateway check --email user@domain.com --since 5m # Generate an alias $ otp-gateway alias github github-a7k2m3@yourdomain.com
Supported Platforms
GitHub
Google
Discord
OpenAI
Anthropic
DeepSeek
AWS
Azure
Vercel
Netlify
Cloudflare
DigitalOcean
HuggingFace
Stripe
+ 15 more