sms8-cli

SMS8 CLI — send SMS & OTP from your terminal via your own Android phone

sms8 is a zero-dependency CLI that sends SMS, generates and verifies OTP codes, and reads your SMS inbox — routed through your own Android phone instead of Twilio. One command. No CPaaS account. No A2P 10DLC paperwork. $29/month flat for unlimited messages.

npx sms8-cli send [phone] "Welcome aboard!"

That's it. The SMS leaves your real mobile number and arrives in the recipient's regular SMS app.

Why use sms8-cli

• Send SMS from any script, cron, CI job, or shell without writing API code
• No Twilio, Vonage, MessageBird, or Plivo account required
• Real phone number as sender — recipients can reply directly to you
• No A2P 10DLC paperwork (US) — these are person-to-person texts from a real SIM
• Free 5-day trial, then $29/mo unlimited — no per-SMS fees, no overages
• Built on the SMS8 platform

Install

# One-off use
npx sms8-cli send [phone] "Hello"

# Or install globally
npm install -g sms8-cli
sms8 send [phone] "Hello"

Node 18 or newer.

Get an API key

• Sign up free at sms8.io (5-day trial, no card required)
• Install the SMS8 Android app, pair your phone
• Copy your API key from app.sms8.io/api.php

Set it once:

export SMS8_API_KEY=sk_xxx
# or
sms8 config set api_key=sk_xxx

Commands

Send an SMS

sms8 send [phone] "Order #1234 shipped — track at example.com/t/1234"

Send a verification code (OTP)

sms8 otp send [phone]
# → 6-digit code arrives on the user's phone

Verify a code

sms8 otp verify [phone] 482937
# → { "verified": true }

Block until a code arrives (perfect for tests, automation)

CODE=$(sms8 otp wait [phone] --timeout=120)
echo "Got code: $CODE"

Inbox

sms8 inbox --limit=10
sms8 inbox --received --limit=20
sms8 inbox --sent --limit=20

Devices

sms8 devices

Account / balance

sms8 balance
sms8 setup

Example: Bash OTP login flow

read -p "Phone (E.164): " PHONE
sms8 otp send "$PHONE"
read -p "Code: " CODE
if sms8 otp verify "$PHONE" "$CODE" | grep -q '"verified": true'; then
  echo "Welcome!"
else
  echo "Wrong code."
fi

Example: CI test that waits for a real SMS

# Trigger a transactional SMS in your app
curl -X POST https://your.app/trigger-otp -d 'phone=[phone]'

# Wait for the code to arrive on the test SIM
CODE=$(sms8 otp wait [phone] --timeout=180)
echo "Code received: $CODE"

# Submit it to your app
curl -X POST https://your.app/verify -d "phone=[phone]&code=$CODE"

Use cases

• OTP / 2FA login in CLI tools, scripts, integration tests
• Order notifications from e-commerce cron jobs
• Status alerts from servers, CI, deployments
• Lead notifications to your sales team's real number
• Bulk reminders — paste a phone list into a shell loop

How it works

Your Android phone runs the free SMS8 app and stays online. Each sms8 command POSTs to the SMS8 cloud, which queues the message; your phone polls, sends the SMS over its real SIM, and reports back. Round-trip is typically under 4 seconds.

What about MCP / Claude Code / Cursor?

Want your AI assistant to send SMS directly? Use the companion package sms8-mcp — it exposes the same tools to any Model Context Protocol client.

{
  "mcpServers": {
    "sms8": {
      "command": "npx",
      "args": ["-y", "sms8-mcp"],
      "env": { "SMS8_API_KEY": "sk_xxx" }
    }
  }
}

Full docs at mcp.sms8.io.

Links

• Home: sms8.io
• Dashboard: app.sms8.io
• API docs: sms8.io/sms-api-documentation
• MCP server: mcp.sms8.io
• Android app: sms8.io/sms-gateway-apk-android
• Issues: github.com/1fancy/sms8-sms-gateway/issues

License

MIT