✓ Verified 📱 Social Media ✓ Enhanced Data

Pidgesms

Send and read SMS text messages via an Android phone using pidge.

Rating
4.5 (106 reviews)
Downloads
10,107 downloads
Version
1.0.0

Overview

Send and read SMS text messages via an Android phone using pidge.

Complete Documentation

View Source →

pidgesms — SMS via pidge

Send and read SMS messages via pidge, a CLI for Android SMS Gateway. The gateway runs on an Android device and pidge connects to it automatically.

pidge reads its config from ~/.config/pidge/config.toml — no env vars needed.

Send SMS

bash
pidge send "+1XXXXXXXXXX" "Your message here"
  • Phone numbers must be E.164 format (e.g. +15551234567)
  • Response includes id and state (Pending → Processed → Sent → Delivered)

Check delivery status

bash
pidge status <message-id>

Read SMS (inbox)

bash
pidge inbox
pidge inbox --unread
pidge inbox --json

Mark message as processed / unprocessed

bash
pidge ack <id>      # mark as processed
pidge unack <id>    # mark as unprocessed

Health check

bash
pidge health

Safety rules

  • Messages are sent to real phone numbers. Always confirm the recipient and content before sending.
  • NEVER send SMS to unknown numbers without explicit owner approval.
  • NEVER send bulk or repeated messages.
  • NEVER send sensitive information (passwords, API keys, tokens, etc.) via SMS.
  • NEVER include the full content of private SMS messages in group chat responses.
  • When showing credentials, prefer a summary — only reveal full message content if directly requested in a private context.

Installation

Terminal bash

openclaw install pidgesms
    
Copied!

💻Code Examples

pidge send "+1XXXXXXXXXX" "Your message here"

pidge-send-1xxxxxxxxxx-your-message-here.txt
- Phone numbers must be E.164 format (e.g. `+15551234567`)
- Response includes `id` and `state` (Pending → Processed → Sent → Delivered)

## Check delivery status
example.sh
pidge inbox
pidge inbox --unread
pidge inbox --json

Tags

#communication

Quick Info

Category Social Media
Model Claude 3.5
Complexity One-Click
Author typhonius
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install pidgesms