Email2Chat Documentation
The easiest way to get email notifications on your phone. Connect in under 60 seconds - no technical knowledge needed. Just sign in with Google or Microsoft and you are done. AI-powered summaries, translations, and classifications via Telegram, WhatsApp, and Slack.
✨ Key Features
🤖 AI-Powered Processing
Summarization, classification, translation, voice messages, and smart reply suggestions - all powered by AI.
⚡ Real-Time Notifications
Hybrid push + polling ensures you get notified within seconds of new emails.
📱 3 Channels
Receive notifications via Telegram, WhatsApp, or Slack - your choice!
🌍 200+ Languages
Translate emails to any of 200+ languages using NLLB-200 model.
🔐 Privacy First
OAuth2 authentication, encrypted tokens, and optional self-hosting.
📊 Smart Classification
Automatically categorize emails as Urgent, Promotional, Updates, and more.
🚀 Quick Start
Get started in under 60 seconds. Simpler than any other email notification service - zero configuration, zero technical knowledge. Everything is automatic!
-
1. Sign Up
Visit email2chat.com/signup and create your account.
-
2. Connect Email (One Click!)
Click "Login with Gmail" or "Login with Microsoft" - single sign-on automatically detects your email provider. No passwords or server settings needed!
-
3. Choose Your Channel
Connect Telegram (scan QR code), WhatsApp, or Slack (one-click OAuth). Notifications start flowing instantly!
-
4. Enable Features
Toggle AI features (summarization, translation, classification) based on your preferences.
-
5. Done! 🎉
You'll now receive instant notifications for new emails with AI-powered insights.
📧 Gmail Setup
Prerequisites
- Active Gmail account
- IMAP enabled in Gmail settings
Step-by-Step Guide
- Click "Login with Gmail" on the dashboard
- Select your Google account
- Grant Email2Chat permission to read your emails
- You'll be redirected back to the dashboard
- Monitoring starts automatically!
What Email2Chat Can Access
- ✅ Read new incoming emails
- ✅ Access email metadata (subject, sender, date)
- ❌ Cannot send emails on your behalf
- ❌ Cannot delete or modify emails
- ❌ Cannot access contacts or other Google services
📧 Microsoft Outlook Setup
Supported Account Types
- Personal accounts: @outlook.com, @hotmail.com, @live.com
- Work/School accounts: Microsoft 365, Office 365 (may require admin consent)
Setup Process
- Click "Login with Microsoft"
- Select account type (Personal or Work/School)
- Enter your Microsoft credentials
- Grant permissions
- Complete!
💬 Telegram Setup
Connecting Your Telegram
- Go to your dashboard
- Find the "Telegram" section under Channel Connections
- Scan the QR code with your Telegram app, or click "Open in Telegram"
- Send
/startto the bot - Connection confirmed! ✅
Telegram Bot Commands
/start- Link your account/help- Get help/status- Check monitoring status
💬 WhatsApp Setup
WhatsApp notifications are available on paid plans.
How to Enable
- Enter your phone number in international format (e.g.,
+96112345678) - Click "Save"
- You'll receive a verification message
- Start receiving WhatsApp notifications!
Slack Setup
Connect your Slack workspace to receive email notifications directly in your DMs. No channel setup needed!
How to Connect
- Go to your Dashboard
- Click Connect Slack
- Authorize Email2Chat in your Slack workspace
- Done! You will receive email notifications in your Slack DMs automatically
IMAP Setup - Other Email Providers
Not using Gmail or Microsoft? Email2Chat supports any email provider that uses IMAP including Yahoo, Sapo.pt, AOL, Zoho, iCloud, GMX and more.
Auto-Detection
Email2Chat automatically detects your email provider settings! Just enter your email address and password - server settings are filled in for you.
How to Connect
- Choose Other Email IMAP during signup
- Enter your email address - server settings are auto-detected
- Enter your email password
- Done! Monitoring starts automatically
🤖 AI Features
Email Summarization
Get concise 120-character summaries of long emails. Perfect for quickly understanding the email content without reading the full text.
Smart Classification
Emails are automatically categorized into:
- 🔴 Urgent: Time-sensitive or important emails
- 📢 Promotional: Marketing and promotional content
- 📰 Updates: Newsletters and updates
- 💬 Personal: Personal correspondence
- 💼 Work: Professional emails
Translation (200+ Languages)
Translate emails to your preferred language using the powerful NLLB-200 model. Popular languages include:
- Arabic (arb_Arab)
- French (fra_Latn)
- Spanish (spa_Latn)
- German (deu_Latn)
- ...and 196 more!
Voice Messages
Convert email summaries to voice notes sent directly to your Telegram. Listen to your emails hands-free while driving, walking, or multitasking.
Smart Reply Suggestions
AI generates context-aware reply suggestions based on the email content. Get quick response ideas without reading the full email - perfect for busy professionals.
🔧 Troubleshooting
Not Receiving Notifications?
- Check that monitoring is active (green dot on dashboard)
- Verify Telegram is connected (shows "Linked as ID: ...")
- Send a test email to yourself
- Check if the bot is blocked in Telegram
- Click "Refresh Token" to refresh your email connection
Token Expired?
If you see "Token expired" or "Reauthorize" button:
- Click "Reauthorize Gmail" or "Reauthorize Microsoft"
- Complete the OAuth flow again
- Monitoring will resume automatically
Telegram Bot Blocked?
- Open Telegram
- Search for the Email2Chat bot
- Unblock the bot
- Click "Get new link" on the dashboard
❓ Frequently Asked Questions
Is Email2Chat free?
We offer a free tier with basic features. Premium features like WhatsApp notifications and voice messages require a paid plan.
How secure is my data?
Very secure! We use OAuth2 authentication, encrypt tokens at rest, and never store your email password. You can also self-host Email2Chat for complete control.
Which email providers are supported?
Gmail, Outlook, Hotmail, Live, Microsoft 365, and Office 365 accounts.
Can I monitor multiple email accounts?
Yes! Add multiple accounts from your dashboard.
How fast are notifications?
Usually within seconds! We use real-time push notifications with polling backup for 100% reliability.
Can I customize which emails trigger notifications?
Yes! Use filters based on sender, subject, or classification (coming soon).
What languages are supported for translation?
200+ languages via the NLLB-200 model. See the full list in your dashboard settings.
🔌 REST API
Authentication
All API requests require a Bearer token in the Authorization header. Generate an API key from your dashboard under Settings → API Keys.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/monitoring/status | All monitored accounts and their current status |
| GET | /api/v1/emails/recent | Recent emails — params: limit, account, provider |
| GET | /api/v1/emails/search | Search emails — params: q, label, account |
| GET | /api/v1/emails/{id}/body | Full body of a specific email |
| POST | /api/v1/emails/{id}/mark-read | Mark an email as read (Outlook only) |
| POST | /api/v1/emails/{id}/archive | Archive an email (Outlook only) |
Example request
🤖 MCP for Claude Desktop
What is MCP?
MCP (Model Context Protocol) is an open standard that lets AI assistants like Claude access external tools. Email2Chat's MCP server lets Claude read and search your monitored emails directly from a conversation — no code, no commands.
What you can ask Claude
- "Show me my latest emails."
- "Find emails about the invoice from last month."
- "Is there anything urgent I missed today?"
- "Summarize emails from John this week."
- "Mark that email as read." (Outlook)
- "Archive the newsletter." (Outlook)
Setup — 4 steps
- Go to /mcp/connect (login required) and generate a free MCP key.
- Copy the one-block JSON config that appears.
- Open Claude Desktop → Settings → Developer → Edit Config and paste it.
- Restart Claude Desktop. Done.
No developer tools, no Python setup required. The uvx email2chat-mcp command runs automatically from the config.
Available MCP tools
get_recent_emails— Fetch recent emails with AI summary and classificationsearch_emails— Search by keyword, sender, or labelget_email_body— Read the full body of any emailget_monitoring_status— Check status of all connected accountsmark_email_read— Mark as read (Outlook only)archive_email— Archive an email (Outlook only)