Skip to main content

app_sms

This tool on every surface: CLI · MCP · Python · JavaScript · Go · Java · .NET

Deliver a simulated text message, to see what an app does when one arrives mid-flow. Emulator only, for the same reason as app_call. Discards the refs from the last app_map.

Changes the device, the app or the session: readOnlyHint is false.

Arguments​

NameTypeRequiredWhat it is
devicestringDevice serial to target, e.g. "emulator-5554". Omit when only one device is running.
driverstring: uiautomator2, uiautomator, wdaDriver to use: "uiautomator2" (default for Android; fast, installs a server APK on first use), "uiautomator" (Android, installs nothing, slower, cannot type), or "wda" (WebDriverAgent: iOS simulators and iPhones).
fromstringSender number. Defaults to 5551234.
textstringyesThe message body.

Examples​

Each is the arguments of a tools/call request; the first is shown whole.

Deliver a text message​

{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "app_sms",
"arguments": {
"text": "Your code is 123456",
"from": "5559876"
}
}
}

On an Android 15 emulator the answer's text was:

delivered a message from 5559876

mobium sms "Your code is 123456" --from 5559876 on an Android 15 emulator

mobium sms "Your code is 123456" --from 5559876 on an Android 15 emulator