Email Setup Guide

Configure email integration to capture verification codes from your inbox and relay them securely to your AI agents.

Overview

Agent OTP can capture verification codes from your email inbox using Gmail API or IMAP integration. When an email matching your agent's request arrives, the system:

1. Detects the incoming email
2. Extracts the verification code from the body
3. Encrypts it with your agent's public key
4. Makes it available for consumption

Integration Options

Gmail API (Recommended for Gmail users)

Uses OAuth 2.0 for secure authentication with Google. Provides real-time push notifications for immediate OTP capture.

• Real-time push notifications
• Minimal latency
• Fine-grained permission scopes
• No password storage required

IMAP (Universal)

Works with any email provider that supports IMAP. Uses app passwords for authentication.

• Works with any email provider
• Self-hosted friendly
• Polling-based (configurable interval)
• Requires app password

Requirements

Gmail API

• Gmail account
• OAuth consent (one-time setup)
• Internet connectivity

IMAP

• Email account with IMAP enabled
• App password (if 2FA enabled)
• IMAP server details

Planned Features

• Gmail OAuth integration
• IMAP support for any provider
• Pattern-based email filtering
• Subject and sender matching
• Code extraction from email body
• Support for HTML emails
• Multiple email account support

Privacy & Security

Email integration is designed with privacy in mind:

• Minimal scope - Only reads emails matching your approved requests
• End-to-end encryption - OTPs are encrypted before storage
• No email storage - Full emails are not stored, only extracted codes
• Revocable access - Disconnect at any time from settings

Common Email Providers

Stay Updated

To be notified when email integration is available:

• Star the GitHub repo
• Watch releases

See Also

• OTP Capture Sources
• Android SMS Setup
• How Encryption Works