capcom6 /android-sms-gateway
The SMS Gateway for Android™ app enables sending and receiving SMS messages through an API that can be accessed directly on the device or via a cloud server when direct device access is not possible.
★ 6,022⑂ 1,082👁 41⑃ 239● 203▤ 154
+9
Daily
6,022
stars
1,082
forks
41
watchers
239
prs
203
issues
154
releases
README
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![Apache 2.0 License][license-shield]][license-url]
SMS Gateway for Android™
Turns your smartphone into an SMS gateway for sending and receiving messages via API.
Explore the docs »
Report Bug
·
Request Feature
- About The Project
- Features
- Ideal For
- Built With
- Installation
- Build Variants
- Prerequisites
- Permissions
- Installation from APK
- Build from Source
- Getting Started
- Local Server
- Cloud Server
- Device Registration
- Unregister Device
- Webhooks
- Supported Events
- Setting Up Webhooks
- Roadmap
- Contributing
- License
- Contact
- Links
About The Project
SMS Gateway turns your Android smartphone into an SMS gateway. It's a lightweight application that allows you to send SMS messages programmatically via an API or CLI tool and receive webhooks on incoming SMS. This makes it ideal for integrating SMS functionality into your own applications or services.
Features
📱 Core Functionality:
- 📝 No personal information required: Creating an account needs no email or personal details. In cloud mode the device is registered only after you sign up or sign in; in local mode you don't need an account at all!
- 📨 Send and Receive SMS via API: Use our API to send messages directly from your applications or services.
- 🤖 Support for Android 5.0 and above: Compatible with Android 5.0 and later versions. See Android 15 Note
- 👤 Explicit device registration: The device never registers itself in the background — in cloud mode you always sign up or sign in first.
- 🗑️ Unregister device: Remove the cloud registration from the device at any time, and sign up or sign in again whenever you need the cloud server.
💬 Message Handling:
- 📜 Multipart messages: Send long messages with auto-partitioning.
- 📊 Message status tracking: Monitor the status of sent messages in real-time.
- 📥 Incoming messages viewer: View all received SMS, Data SMS, and MMS messages directly in the app with organized tabs and statistics.
- 🔔 Real-time incoming message notifications: Receive instant SMS and MMS notifications via webhooks.
- 📖 Read received messages: Access previously received messages via the same webhooks used for real-time notifications.
- 📎 MMS download notifications: Receive webhook notifications when MMS messages are fully downloaded, including message body and attachments.
- 📤 Send MMS messages via API: Send multimedia messages (images, audio, video, files) as Base64-encoded attachments, with an optional subject and text body.
- 🖼️ Received MMS attachments: Attachments of received MMS messages are stored on the device and can be fetched through the inbox API.
- 📦 Batch webhook events: Receive batched webhook deliveries when multiple messages arrive at once, reducing tTop issues
#165Propose the application on F-Droid12 comments · 2024-12-27#427Feature request: expose outgoing SMS composed on the device (sms:device-sent)7 comments · 2026-08-17#432MMS webhook messageId is the device-local content://mms row id — resets on handset replacement and silently defeats consumer-side dedupe6 comments · 2026-08-23#330SMSes getting stuck at pending6 comments · 2026-03-13#439Private Server rejects non-empty webhooks.signing_key via settings API5 comments · 2026-08-29#333the Android phone always pop up a confirm windows while sending a SMS4 comments · 2026-03-24#479By Code login field only accepts digits, but server one-time codes are alphanumeric3 comments · 2026-11-10#454Time-zone handling offset added twice.3 comments · 2026-10-14
Discussions
#461T-Mobile US: sending occasional MMS announcements to 200 recipients0 comments · 2026-10-20#448Home Assistant integration: ha-smsgateway1 comments · 2026-09-21#400Is there a way to allow non-mobile numbers (Korean "safe numbers", 050x prefix)?1 comments · 2026-07-13#37332331241490 comments · 2026-05-30#349Does the app support installation on an Android emulator on a PC?1 comments · 2026-04-09#335are these docs out of date?1 comments · 2026-03-31#332Is there some way to check webhook health?1 comments · 2026-03-17#326Mobile app. Messages in the "Processed" state1 comments · 2026-03-10
Latest release
v1.78.3 v1.78.3 2026-11-10What's Changed [docs] fix partsCount in swagger and add missing webhook payload schemas by @capcom6 in https://github.com/capcom6/android-sms-gateway/pull/456 Full Changelog: https://github.com/capcom6/android-sms-gateway/compare/v1.78.2...v1.78.3 What's Changed [docs] fix partsCount in swagger and add missing webhook payload schemas by @capcom6 in https://github.com/capcom6/android-sms-gateway/pull/456 Full Changelog: https://github.com/capcom6/android-sms-gateway/compare/v1.78.2...v1.78.3