lynx-android-automation

Android SMS automation toolkit with:

• ADB + Google Messages SMS sender
• Local HTTP API
• Cloudflare Tunnel stack launcher
• MCP server for AI tool calling

Requirements

• macOS/Linux shell
• adb available in PATH
• python3 available in PATH
• cloudflared available in PATH for public tunnel mode
• An Android device connected and authorized through ADB
• Google Messages as the default SMS app

Install

npm install -g lynx-android-automation

One-command stack

lynx-sms-stack

The command starts the local SMS API, starts a Cloudflare quick tunnel, then prints:

• API key
• public API URL
• curl examples
• MCP config JSON

Stop the stack:

lynx-sms-stack stop

Check status:

lynx-sms-stack status

Run API only

SMS_API_KEY='your-secret-token' lynx-sms-api --host 127.0.0.1 --port 8787 --device 94QAY0RY0S

Run MCP server

SMS_API_URL='https://your-tunnel.trycloudflare.com' \
SMS_API_KEY='your-secret-token' \
lynx-sms-mcp

MCP config

Use the npm registry package directly, without cloning this repository:

{
  "mcpServers": {
    "android-sms": {
      "command": "npx",
      "args": [
        "-y",
        "--package",
        "lynx-android-automation@latest",
        "lynx-sms-mcp"
      ],
      "env": {
        "SMS_API_URL": "https://your-tunnel.trycloudflare.com",
        "SMS_API_KEY": "your-secret-token"
      }
    }
  }
}

See MCP_REMOTE_CONFIG.md for a copy-paste JSON config to share with other users.

Send directly from CLI

lynx-sms-send --device 94QAY0RY0S 0912205001 "Alo azaiii"

Dry run:

lynx-sms-send --device 94QAY0RY0S --dry-run 0912205001 "Alo azaiii"

MCP tools

• probe_device
• dry_run_sms
• send_sms

Use send_sms only when the user explicitly asks to send a message.