Repolode
Submit
capcom6

capcom6/android-sms-gateway

Turns an Android phone into an SMS gateway, letting you send and receive SMS and MMS through a local or cloud API.

View on GitHubWebsite
Stars
5,905
Forks
1,052
Open issues
16
Last commit
12 hours ago

What is it?

SMS Gateway for Android is an app that turns an Android phone into an SMS gateway. Programs can send messages through a local HTTP server on the device or through a cloud server, which is useful when the phone's IP address is dynamic or unreachable. Clients can also use the bundled CLI tool.

The app supports sending SMS, multipart long messages, and MMS with attachments. It reports delivery status, supports scheduled sending and cancellation of queued messages, and can rate-limit sending. Incoming SMS, data SMS, and MMS are delivered to your server through webhooks, with batched delivery when many messages arrive at once.

For privacy, message content and recipient numbers can be end-to-end encrypted, and you can run your own private server. The app works with multiple SIM cards and multiple devices on one account, and supports Android 5.0 and later.

Key features

  • 01Send SMS and MMS with attachments through a local or cloud API
  • 02Receive incoming SMS, data SMS, and MMS via webhooks
  • 03Track message status and cancel queued messages
  • 04Schedule messages and limit sending rate per period
  • 05End-to-end encryption of message content and phone numbers
  • 06Supports multiple SIM cards and multiple devices

Use cases

  • Sending two-factor authentication codes from your own backend
  • Delivering transactional confirmations and appointment reminders
  • Forwarding incoming SMS to an internal system through webhooks
  • Sending SMS from a local network without a third-party SMS provider

Quick start

  1. 1

    Download the latest APK from the Releases page

  2. 2

    Install the APK on your Android device

  3. 3

    Build from source: run the unit test suite

    ./gradlew test
  4. 4

    Build the secure release APK

    ./gradlew assembleRelease

Things to know

  • Requires an Android device running Android 5.0 or later, so it cannot run on iPhone or other platforms.
  • Building from source needs Firebase config (app/google-services.json) and a signing keystore that are not committed to the repo.
  • The README advises against using it for batch sending due to mobile operator restrictions.

Topics

#sms#android#api#gateway#webhook#mms#self-hosted#encryption#httpsms#sim

FAQ

What is android-sms-gateway?
Turns an Android phone into an SMS gateway, letting you send and receive SMS and MMS through a local or cloud API. SMS Gateway for Android is an app that turns an Android phone into an SMS gateway. Programs can send messages through a local HTTP server on the device or through a cloud server, which is useful when the phone's IP address is dynamic or unreachable. Clients can also use the bundled CLI tool.
Is android-sms-gateway free to use? What license does it have?
android-sms-gateway is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is android-sms-gateway still maintained?
Actively maintained. The last commit to android-sms-gateway was on Oct 19, 2026.
What can I use android-sms-gateway for?
Sending two-factor authentication codes from your own backend Delivering transactional confirmations and appointment reminders Forwarding incoming SMS to an internal system through webhooks Sending SMS from a local network without a third-party SMS provider
How do I install android-sms-gateway?
Download the latest APK from the Releases page Install the APK on your Android device Build from source: run the unit test suite: ./gradlew test Build the secure release APK: ./gradlew assembleRelease
Where can I get android-sms-gateway?
The source code and installation instructions are on GitHub: https://github.com/capcom6/android-sms-gateway

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects