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

CODEBLOCK0

• - Phone numbers must be E.164 format (e.g. +15551234567)
• Response includes id and state (Pending → Processed → Sent → Delivered)

Check delivery status

CODEBLOCK1

Read SMS (inbox)

CODEBLOCK2

Mark message as processed / unprocessed

CODEBLOCK3

Health check

CODEBLOCK4

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.