About This Application
What is Household Bot?
Household Bot is an application that allows users to connect their Gmail inbox via Google OAuth 2.0 and automatically forward critical email content — such as Netflix Household verification links, one-time passwords (OTPs), and sign-in codes — directly to a designated Telegram bot or channel.
The application uses the https://www.googleapis.com/auth/gmail.readonly Google API scope
to read incoming emails on behalf of the user. It scans only for specific verification-related emails
and forwards the extracted code or link via Telegram instantly.
Google API Data Use & Disclosure
🔒 Google OAuth 2.0 Data Disclosure
Household Bot uses the following Google API permission:
https://www.googleapis.com/auth/gmail.readonly
What this allows:
- Read-only access to your Gmail inbox messages and metadata.
- Search for specific emails from Netflix, streaming services, and other providers containing OTP codes or household verification links.
What we do NOT do:
- We do not read, store, or share personal emails unrelated to verification.
- We do not write, send, or delete any emails.
- We do not sell, share, or transfer your Gmail data to any third party.
Data handling: Email content is processed entirely in-memory on our server. Only the extracted verification code or link is forwarded to Telegram. Raw email data is discarded immediately and never persisted to disk or a database.
Household Bot's use and transfer of information received from Google APIs to any other app will adhere to the Google API Services User Data Policy, including the Limited Use requirements.
How It Works
Application Flow
- User connects their Gmail account to Household Bot using Google OAuth 2.0 (read-only access).
- Household Bot monitors the inbox for incoming emails from Netflix, streaming providers, or any configured sender.
- When a matching email arrives containing an OTP code or household verification link, the content is extracted in memory.
- The extracted code or link is forwarded instantly to the user's configured Telegram bot channel.
- The raw email data is discarded. Nothing is stored beyond the OAuth refresh token (encrypted).
🛡️ Security & Token Management
OAuth tokens granted by users are stored encrypted on our servers and used exclusively to poll Gmail on behalf of that user. Users can revoke access at any time through their Google Account Permissions page, which will immediately invalidate all stored tokens.