Verifee is a Discord bot that securely fetches the latest verification codes (2FA / OTP) from a connected Gmail account and displays them directly in your Discord channel. It's designed to streamline login processes for shared accounts or teams.
- Gmail Fetching: Scans the inbox for the latest emails within the last 15 minutes.
- Keyword Filtering: Specify a keyword (e.g.,
!code steam) to find codes from specific services. - Smart Parsing: Automatically extracts 6-digit verification codes from email bodies.
- Security: Ignores "password reset" emails to prevent accidental account compromises.
- Docker Ready: Includes a
Dockerfileanddocker-compose.yml.
- Python 3.9+
- Discord Bot Token: Create one at the Discord Developer Portal.
- Gmail Account:
- 2-Step Verification must be enabled.
- An App Password must be generated (use this instead of your real password).
-
Clone the repository:
git clone https://github.com/yourusername/Verifee.git cd Verifee -
Create a virtual environment (optional):
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
-
Install dependencies:
pip install -r requirements.txt
-
Configure Environment Variables: Create a file named
.envin the root directory and add your credentials:DISCORD_TOKEN=your_discord_bot_token EMAIL_ADDRESS=your_email@gmail.com EMAIL_PASSWORD=your_gmail_app_password
-
Run the bot:
python bot.py
-
Discord Commands:
!code: Searches the inbox for any recent verification code.!code [service]: Searches for a code from a specific service (e.g.,!code Amazon).
Run locally with Docker Compose:
- Configure: Ensure
.envis created. - Run:
docker-compose up -d --build
For a step-by-step guide on deploying this bot to an Amazon EC2 instance, see EC2_INSTRUCTIONS.md.