sms

name	sms
description	Read and send SMS messages. Use for checking texts, 2FA codes, or sending SMS alerts.

SMS Operations

Read recent messages

termux-sms-list                        # last 10 messages
termux-sms-list -l 5                   # last 5 messages
termux-sms-list -t inbox               # inbox only
termux-sms-list -t sent                # sent only

Filter by sender

termux-sms-list -f "[phone]" -l 5  # from specific number

Get conversations list

termux-sms-list --conversation-list

Send SMS

termux-sms-send -n "[phone]" "Message text"

Output format (list)

[
  {
    "threadid": 1,
    "type": "inbox",
    "read": true,
    "number": "[phone]",
    "received": "2024-01-15 10:30:00",
    "body": "Message content here"
  }
]

Message types

• all (default), inbox, sent, draft, outbox, failed, queued

Note: Requires SMS permissions in Termux:API app settings.