Repolode
Submit
chenxuuu

chenxuuu/sms_forwarding

Low-cost hardware SMS forwarder built on an ESP32-C3 and ML307R-DC cellular module, pushing received texts to webhooks, email and chat apps.

View on GitHubWebsite
Stars
1,571
Forks
283
Open issues
9
Last commit
2 months ago

What is it?

This project turns a cheap ESP32-C3 board plus an ML307R-DC 4G module into a dedicated device that receives SMS and forwards each message automatically. The ESP32-C3 connects to WiFi and talks to the cellular module over UART using standard AT commands, then sends incoming texts to HTTP endpoints or email.

Up to five push channels can be enabled at once, each configured separately. Supported targets include generic POST JSON and GET requests, custom JSON templates, Bark for iOS, DingTalk and Feishu bots, PushPlus, and Server酱. A built-in web interface handles configuration, status checks, manual SMS sending and ping tests to keep the SIM card active. The project is limited to receiving messages and account-maintenance functions, and the hardware setup targets mainland China carriers.

Key features

  • 01Forwards received SMS to up to five channels simultaneously.
  • 02Supports POST JSON, GET, custom templates, Bark, DingTalk, Feishu, PushPlus and Server酱.
  • 03Forwards messages to email.
  • 04Merges long SMS automatically with a 30-second timeout.
  • 05Web interface for configuration, status, manual SMS sending and ping tests.
  • 06Talks to the modem through standard AT commands.

Use cases

  • Receiving bank or service verification SMS on a server or phone without the SIM card in your handset.
  • Pushing SMS alerts to a phone via Bark or Server酱.
  • Keeping an unused SIM card active with periodic pings.
  • Sending messages into a DingTalk or Feishu group for team notifications.

Quick start

  1. 1

    Wire the ESP32C3 to the ML307R-DC module over UART as shown in the README

  2. 2

    Install the ESP32 board support in Arduino IDE and select MakerGO ESP32 C3 SuperMini

  3. 3

    Install the libraries ReadyMail and pdulib in Arduino IDE

  4. 4

    Flash the Arduino firmware to the ESP32C3 and configure forwarding via the web interface

Things to know

  • Only receives SMS; calls, dialing and multi-SIM control are not supported.
  • Hardware assembly requires soldering or buying a pre-made kit.
  • The standalone build supports only China Mobile and China Unicom SIMs.

In collections

Embedded systems & microcontroller projects

Topics

#sms#iot#esp32#hardware#webhook#notification#at-commands

FAQ

What is sms_forwarding?
Low-cost hardware SMS forwarder built on an ESP32-C3 and ML307R-DC cellular module, pushing received texts to webhooks, email and chat apps. This project turns a cheap ESP32-C3 board plus an ML307R-DC 4G module into a dedicated device that receives SMS and forwards each message automatically. The ESP32-C3 connects to WiFi and talks to the cellular module over UART using standard AT commands, then sends incoming texts to HTTP endpoints or email.
Is sms_forwarding free to use? What license does it have?
sms_forwarding is open source under the MIT license. Check the license terms before using it in commercial products.
Is sms_forwarding still maintained?
Updated within 6 months. The last commit to sms_forwarding was on Aug 25, 2026.
What can I use sms_forwarding for?
Receiving bank or service verification SMS on a server or phone without the SIM card in your handset. Pushing SMS alerts to a phone via Bark or Server酱. Keeping an unused SIM card active with periodic pings. Sending messages into a DingTalk or Feishu group for team notifications.
How do I install sms_forwarding?
Wire the ESP32C3 to the ML307R-DC module over UART as shown in the README Install the ESP32 board support in Arduino IDE and select MakerGO ESP32 C3 SuperMini Install the libraries ReadyMail and pdulib in Arduino IDE Flash the Arduino firmware to the ESP32C3 and configure forwarding via the web interface
Where can I get sms_forwarding?
The source code and installation instructions are on GitHub: https://github.com/chenxuuu/sms_forwarding

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

Related projects