android-sms-gateway
by nadjihamid
Coding Agents & IDEsBrief
Self-hosted SMS via Android phone HTTP API.
Description
What This Skill Does
Sends and receives SMS messages through an Android phone running a local HTTP API gateway app. The phone acts as the SMS modem, eliminating reliance on third-party SMS providers. Supports multiple gateway apps including SMS Gateway API, SMSGate, and capcom6/android-sms-gateway.
Keeps SMS traffic entirely on your own hardware and network, avoiding per-message fees and data sharing with commercial SMS API providers.
When to Use It
- Send security alerts when a vulnerability scan finds issues
- Deliver 2FA verification codes from a self-hosted auth system
- Trigger SMS notifications from Nagios or Zabbix monitoring
- Schedule daily reminders via cron without a cloud SMS service
- Broadcast bulk alerts to a list of contacts during an incident
Example Workflow
User asks: send an SMS alert to +1234567890 saying the security scan is complete
- 1
Reads SMS_GATEWAY_URL and SMS_GATEWAY_TOKEN from environment or config file
- 2
Calls send_sms.sh with --to and --message flags
- 3
Script POSTs to the Android gateway HTTP API with Bearer token auth
- 4
Gateway app on the phone transmits the SMS over the carrier network
- 5
Script returns delivery confirmation or error from the API response
SMS delivered to +1234567890: "Alert: Security scan complete"
Requirements
- Android phone with an SMS gateway app installed (SMS Gateway API, SMSGate, or capcom6/android-sms-gateway)
- SMS_GATEWAY_URL environment variable pointing to the phone's HTTP API
- SMS_GATEWAY_TOKEN or SMS_GATEWAY_USER/SMS_GATEWAY_PASS credentials configured in the gateway app
- Phone and OpenClaw host on the same network, or port forwarding configured
Installation
clawhub install nadjihamid/android-sms-gatewayRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.