How do I install the Sms Gateway skill?

Run npx skillmds@latest add dvcrn/sms-gateway in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Sms Gateway safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Sms Gateway?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Sms Gateway free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Sms Gateway?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Sms Gateway by dvcrn — Agent Skill

Name: Sms Gateway
Rating: 4.2 (5 reviews)
Author: dvcrn

Sms Gateway

Send and receive SMS using a local sms-gate.app instance running on Android (via Termux) or a dedicated device. Use when the user needs to send text messages, check delivery status, list message history, or manage webhooks for incoming SMS.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

SMS Gateway

Interact with a local sms-gate.app instance to send and receive SMS through an Android device.

Setup

Requires environment variables:

SMS_GATE_URL — Your gateway URL (e.g., http://192.168.50.69:8080)
SMS_GATE_USER — HTTP Basic Auth username
SMS_GATE_PASS — HTTP Basic Auth password

Quick Start

Send an SMS:

python3 scripts/send_sms.py '+41787008998' 'Hello from OpenClaw!'

Check delivery status:

python3 scripts/check_status.py 'VdHHQ3nlNwDZ-W9SNuLzm'

List recent messages:

python3 scripts/list_messages.py 20

Operations

Sending SMS

Use scripts/send_sms.py:

python3 scripts/send_sms.py '<phone_number>' '<message>' [delivery_report]

Phone numbers can include + prefix (will be normalized). Delivery report is true by default.

Checking Status

Use scripts/check_status.py with the message ID returned from send:

python3 scripts/check_status.py '<message_id>'

States: Pending → Sent → Delivered (or Failed)

Listing Messages

Use scripts/list_messages.py:

python3 scripts/list_messages.py [limit]

Shows both sent (📤) and received (📥) messages with their current state.

Managing Webhooks

Use scripts/manage_webhooks.py:

# List configured webhooks
python3 scripts/manage_webhooks.py list

# Add webhook for incoming SMS
python3 scripts/manage_webhooks.py add sms:received https://your-server.com/sms

# Add delivery confirmation webhook
python3 scripts/manage_webhooks.py add sms:delivered https://your-server.com/delivered

# Delete webhook
python3 scripts/manage_webhooks.py delete sms:received

API Reference

See references/api.md for complete endpoint documentation.

Common Patterns

Send with status check:

# Send and capture ID
MSG_ID=$(python3 scripts/send_sms.py '+41787008998' 'Test' 2>&1 | grep "ID:" | awk '{print $3}')

# Check status after a few seconds
sleep 5
python3 scripts/check_status.py "$MSG_ID"

Health check:

python3 scripts/health.py

Receiving SMS (Incoming)

The sms-gate.app API doesn't store message content - it only delivers via webhooks. To receive incoming SMS:

Option 1: Webhook Server + ngrok (Recommended)

1. Start the webhook receiver:

python3 scripts/webhook_server.py 8787

2. Expose via ngrok:

ngrok http 8787
# Copy the https://xxxx.ngrok-free.app URL

3. Configure webhook:

python3 scripts/manage_webhooks.py add sms:received https://xxxx.ngrok-free.app/sms-received

Now incoming SMS will be printed to the webhook server console.

Option 2: Local Network (Same WiFi)

If Pixel 3 and Mac are on same network:

# Get Mac IP
ipconfig getifaddr en0
# Configure webhook directly (if gateway allows HTTP)
python3 scripts/manage_webhooks.py add sms:received http://<mac-ip>:8787/sms-received

Notes

The Android device must have SMS capability and be on the same network (or accessible via tunnel like Cloudflare)
Webhooks require HTTPS for remote access (ngrok provides this)
Message content is only available via webhooks, not stored in /messages API
Message IDs are URL-safe strings returned after sending

---name: sms-gatewaydescription: Send and receive SMS using a local sms-gate.app instance running on Android (via Termux) or a dedicated device. Use when the user needs to send text messages, check delivery status, list message history, or manage webhooks for incoming SMS.---# SMS GatewayInteract with a local **sms-gate.app** instance to send and receive SMS through an Android device.## SetupRequires environment variables:- `SMS_GATE_URL` — Your gateway URL (e.g., `http://192.168.50.69:8080`)- `SMS_GATE_USER` — HTTP Basic Auth username- `SMS_GATE_PASS` — HTTP Basic Auth password## Quick Start**Send an SMS:**```bashpython3 scripts/send_sms.py '+41787008998' 'Hello from OpenClaw!'```**Check delivery status:**```bashpython3 scripts/check_status.py 'VdHHQ3nlNwDZ-W9SNuLzm'```**List recent messages:**```bashpython3 scripts/list_messages.py 20```## Operations### Sending SMSUse `scripts/send_sms.py`:```bashpython3 scripts/send_sms.py '<phone_number>' '<message>' [delivery_report]```Phone numbers can include `+` prefix (will be normalized). Delivery report is `true` by default.### Checking StatusUse `scripts/check_status.py` with the message ID returned from send:```bashpython3 scripts/check_status.py '<message_id>'```States: `Pending` → `Sent` → `Delivered` (or `Failed`)### Listing MessagesUse `scripts/list_messages.py`:```bashpython3 scripts/list_messages.py [limit]```Shows both sent (📤) and received (📥) messages with their current state.### Managing WebhooksUse `scripts/manage_webhooks.py`:```bash# List configured webhookspython3 scripts/manage_webhooks.py list# Add webhook for incoming SMSpython3 scripts/manage_webhooks.py add sms:received https://your-server.com/sms# Add delivery confirmation webhookpython3 scripts/manage_webhooks.py add sms:delivered https://your-server.com/delivered# Delete webhookpython3 scripts/manage_webhooks.py delete sms:received```## API ReferenceSee [references/api.md](references/api.md) for complete endpoint documentation.## Common Patterns**Send with status check:**```bash# Send and capture IDMSG_ID=$(python3 scripts/send_sms.py '+41787008998' 'Test' 2>&1 | grep "ID:" | awk '{print $3}')# Check status after a few secondssleep 5python3 scripts/check_status.py "$MSG_ID"```**Health check:**```bashpython3 scripts/health.py```## Receiving SMS (Incoming)The sms-gate.app API doesn't store message content - it only delivers via webhooks. To receive incoming SMS:### Option 1: Webhook Server + ngrok (Recommended)**1. Start the webhook receiver:**```bashpython3 scripts/webhook_server.py 8787```**2. Expose via ngrok:**```bashngrok http 8787# Copy the https://xxxx.ngrok-free.app URL```**3. Configure webhook:**```bashpython3 scripts/manage_webhooks.py add sms:received https://xxxx.ngrok-free.app/sms-received```Now incoming SMS will be printed to the webhook server console.### Option 2: Local Network (Same WiFi)If Pixel 3 and Mac are on same network:```bash# Get Mac IPipconfig getifaddr en0# Configure webhook directly (if gateway allows HTTP)python3 scripts/manage_webhooks.py add sms:received http://<mac-ip>:8787/sms-received```## Notes- The Android device must have SMS capability and be on the same network (or accessible via tunnel like Cloudflare)- Webhooks require HTTPS for remote access (ngrok provides this)- Message content is only available via webhooks, not stored in `/messages` API- Message IDs are URL-safe strings returned after sending

Frequently asked questions