Automatic SMS Forwarding to Email — Never miss important messages, get OTPs anywhere, forward SMS globally.

SMS Gateway is an open-source Android app that automatically forwards incoming SMS messages to your email address in real-time. Perfect for travelers, remote workers, or anyone who needs SMS notifications on multiple devices.

• ✅ Automatic SMS Forwarding — Receive SMS via email instantly
• ✅ Background Processing — Works even when app is closed
• ✅ Global Coverage — Works in any country with any carrier
• ✅ Local Storage — Keep 20 recent SMS messages locally
• ✅ Free Email Service — Uses Brevo (300 free emails/day)
• ✅ Simple Setup — Configure in 5 minutes
• ✅ Privacy Focused — All data processed locally
• ✅ Open Source — MIT License, fully auditable

Scenario: You moved to another country for work
Problem: Your home country's SIM is inactive, missing OTP messages
Solution: Activate SMS Gateway on an old phone with a local SIM
Result: All SMS sent to your email automatically

Scenario: Team members spread across different locations
Problem: Can't coordinate SMS notifications
Solution: SMS Gateway centralizes all SMS to team email
Result: No missed important messages

Scenario: Receiving 2FA codes from banks/apps
Problem: Need phone to verify, not always available
Solution: Enable SMS Gateway
Result: OTPs arrive in email within seconds

Scenario: Need SMS archive for compliance
Problem: Manual recording is tedious
Solution: SMS Gateway automatically archives all SMS
Result: Complete SMS history in your email

Scenario: Want SMS on laptop/tablet
Problem: SMS only arrives on phone
Solution: SMS Gateway forwards to your email
Result: Access SMS from any device

• ✅ Android 8.0+ device
• ✅ Active mobile number (any carrier)
• ✅ Free Brevo account (https://www.brevo.com)
• ✅ Email address

1. Get Brevo API Key (5 min)

   • Sign up at https://www.brevo.com (FREE)
   • Go to Settings → API & Apps → Copy API key

2. Verify Sender Email (2 min)

   • In Brevo: Settings → Sender & Domains
   • Add your email and verify it

3. Configure App (1 min)

   • Enter Target Email (where SMS arrives)
   • Enter Sender Email (verified in Brevo)
   • Paste Brevo API key
   • Click "Save Configuration"

4. Enable Service (30 sec)

   • Toggle "Forwarding Service" ON
   • Send test SMS
   • Check your email ✓

1. Download latest APK from Releases
2. Enable "Unknown Sources" in Android Settings
3. Install APK file
4. Grant SMS permissions
5. Done!

Node.js >= 20
Android SDK
Java Development Kit (JDK)
React Native CLI

# 1. Clone repository
git clone https://github.com/mitulp236/sms-gateway.git
cd sms-gateway

# 2. Install dependencies
npm install

# 3. Install Android dependencies
cd android && ./gradlew clean && cd ..

# 4. Connect Android device or start emulator
adb devices

# 5. Build and run
npx react-native run-android

# 6. To build APK
cd android
./gradlew assembleRelease
cd ..
# APK location: android/app/build/outputs/apk/release/app-release.apk

# Build signed release APK
cd android
./gradlew bundleRelease
# Then sign the bundle and generate APK

# Or use this for debug APK
./gradlew assembleDebug
cd ..
# Output: android/app/build/outputs/apk/debug/app-debug.apk

┌─────────────────┐
│  Incoming SMS   │
│   (Carrier)     │
└────────┬────────┘
         │
         ▼
┌─────────────────────────────┐
│  SmsReceiver.java           │
│  (BroadcastReceiver)        │
│  Catches SMS in real-time   │
└────────┬────────────────────┘
         │
         ▼
    ┌────────────────────────────┐
    │ Check if service enabled?  │
    │ (SharedPreferences)        │
    └────────┬────────┬──────────┘
    Yes      │        │      No
    │        └────────┘
    ▼                  ▼
┌─────────────────┐   (Ignore)
│ WorkManager Job │
│ SmsSendWorker   │
└────────┬────────┘
         │
         ▼
┌────────────────────────────────┐
│  Build Email Payload           │
│  - From: Verified Sender Email │
│  - To: Target Email            │
│  - Body: SMS content           │
└────────┬───────────────────────┘
         │
         ▼
┌────────────────────────────────┐
│  Send via Brevo API            │
│  https://api.brevo.com/v3/...  │
└────────┬───────────────────────┘
         │
         ▼
    ✓ Success        ✗ Failed
    │                │
    ▼                ▼
┌──────────────┐   Retry
│ Email Sent   │   (Auto-retry)
│ to Inbox     │
└──────────────┘

Configuration Screen	Service Status	Recent Messages

Home Screen	Drawer Menu	How It Works

💡 Replace placeholder images with actual screenshots from your device

• ❌ SMS messages on external servers
• ❌ Your email addresses anywhere
• ❌ API keys on cloud
• ❌ Phone number data
• ❌ Message history on servers

• ✅ All data stored locally on your device
• ✅ You manage Brevo API key
• ✅ You choose recipient email
• ✅ You can delete messages anytime
• ✅ Open source code (fully auditable)

<!-- Receive incoming SMS -->
<uses-permission android:name="android.permission.RECEIVE_SMS" />

<!-- Read SMS (for history) -->
<uses-permission android:name="android.permission.READ_SMS" />

<!-- Internet (to send emails) -->
<uses-permission android:name="android.permission.INTERNET" />

1. Visit https://www.brevo.com
2. Click "Sign Up Free"
3. Complete registration
4. Verify your email
5. Dashboard opens (FREE: 300 emails/day)

Brevo Dashboard
├── Settings (gear icon)
├── API & Apps
├── SMTP & API (tab)
├── API Keys section
├── Copy your API key (starts with xkeysib-)
└── Keep it safe!

Brevo Dashboard
├── Settings
├── Sender & Domains
├── Add Sender Email
├── Verify email (confirmation link)
├── Wait for verification
└── Now you can use it in SMS Gateway

1. Open App

   • Install SMS Gateway

2. Fill Configuration

   Target Email: [email protected]
   Sender Email: [email protected] (verified in Brevo)
   Brevo API Key: xkeysib-xxxxxxxxxxxx
   

3. Save Configuration

   • Tap "💾 Save Configuration"
   • See green checkmark

4. Test Email

   • Tap "📨 Send Test Email"
   • Check your email for test message

5. Enable Service

   • Toggle "Forwarding Service" ON
   • See green "● Active (Background)"

6. Done! 🎉

   • Now all SMS → Email automatically

Check 1: Service Enabled?

✓ Toggle should be green/ON
✓ Says "● Active (Background)"

Check 2: Configuration Saved?

✓ Green banner shows "✓ Configuration Saved & Synced"
✓ Test email works first

Check 3: Brevo Setup

✓ Sender email verified in Brevo (not pending)
✓ API key correct (starts with xkeysib-)
✓ Brevo account not out of daily quota

Check 4: SMS Received?

✓ Sender number appears in "Recent Messages"
✓ Message shows in SMS app

Check 5: Check Spam Folder

✓ Gmail: Check "All Mail", Promotions, Spam
✓ Outlook: Check Junk folder
✓ Other: Add sender to contacts

Possible Causes:

1. Force Stopped App → Solution: Open app, toggle service back ON
2. Battery Optimization → Solution: Settings → Battery → Exempt SMS Gateway
3. Device Sleep → Solution: Keep device on or disable deep sleep
4. Brevo Down → Solution: Check status at status.brevo.com

Solution:
1. Tap "Save Configuration" button
2. Fill ALL three fields (don't leave blank)
3. Test email first
4. Then toggle service ON

We welcome contributions!

1. Fork the repository
2. Create feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open Pull Request

# Clone your fork
git clone https://github.com/YOUR_USERNAME/sms-gateway.git

# Create feature branch
git checkout -b feature/your-feature

# Make changes and test
npm run android

# Run linter
npm run lint

# Commit and push
git add .
git commit -m "feat: add your feature"
git push origin feature/your-feature

• ✅ Follow React Native best practices
• ✅ Add comments for complex logic
• ✅ Test on real Android device
• ✅ Update README if adding features
• ✅ Keep native code clean and documented

Create an Issue:

1. Describe the bug
2. Steps to reproduce
3. Expected vs actual behavior
4. Device info (Model, Android version)

sms-gateway/
├── App.js                          # Main React Native component
├── android/
│   ├── app/src/main/
│   │   ├── java/com/smsforwarder/
│   │   │   ├── MainActivity.kt     # Android main activity
│   │   │   ├── SmsReceiver.java    # BroadcastReceiver for SMS
│   │   │   ├── SmsSendWorker.java  # WorkManager job
│   │   │   ├── SmsReceiverModule.java
│   │   │   └── SmsReceiverPackage.java
│   │   ├── AndroidManifest.xml     # Permissions & receivers
│   │   └── res/                    # Resources
│   ├── build.gradle                # Dependencies
│   └── gradlew                     # Gradle wrapper
├── ios/                            # iOS placeholder (Android only)
├── package.json                    # Node dependencies
├── README.md                       # This file
└── LICENSE                         # MIT License

This project is licensed under the MIT License - see LICENSE file for details.

MIT License

Copyright (c) 2025 Mitul Patel

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software...

Mitul Patel

• 📧 Email: [email protected]
• 🌐 Website: mitulpatel.in/about
• 💻 GitHub: @mitulp236

Give a ⭐ if this project helped you!

# You can also support by:
# 1. Sharing with others
# 2. Contributing code
# 3. Reporting bugs
# 4. Suggesting features

• ✅ SMS forwarding to email
• ✅ Background processing
• ✅ Message history
• ✅ Brevo integration

• 🔜 Multiple recipient emails
• 🔜 SMS filtering (keywords)
• 🔜 Email templates
• 🔜 Dark mode

• 💭 Web dashboard
• 💭 SMS reply via email
• 💭 Cloud backup
• 💭 iOS support (may require fork)

Q: Does this work without internet?

A: SMS receiving works without internet. Email forwarding requires internet to reach Brevo API.

Q: Is my data safe?

A: Yes! All data is stored locally. We don't send SMS content anywhere except to your email.

Q: Can I use my own email service?

A: Currently Brevo only. Contributions welcome to add other providers!

Q: What if app crashes?

A: WorkManager automatically retries failed emails (5+ attempts).

Q: How many SMS can I forward?

A: Unlimited! Brevo gives 300 free emails/day. Pay plans available for more.

Q: Does battery drain?

A: Minimal. WorkManager is battery optimized. SMS receiving is system event (negligible impact).

Q: Can I forward SMS to multiple emails?

A: v1.0.0 supports one target email. Multi-recipient in v1.1.0!

• 💬 GitHub Issues: Report bugs or request features
• 📧 Email: [email protected]
• 🌐 Website: mitulpatel.in/about

New to Android development? Check these resources:

• React Native Docs
• Android BroadcastReceiver
• Android WorkManager
• Brevo API Docs

• 📱 Platform: Android 8.0+
• 🔧 Built with: React Native
• 📦 Size: ~40MB
• ⚡ Performance: Optimized for background operation
• 🔒 Security: Local-first, privacy-focused
• 📄 License: MIT (Open Source)

• React Native community
• Brevo team for free email API
• All contributors and testers
• You for reading this! 👋

• ✨ Initial release
• ✅ SMS to email forwarding
• ✅ Background processing
• ✅ Message history
• ✅ Professional UI/UX