Skip to main content

app_battery

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

Read the battery: level in percent, whether it is charging, discharging, not charging or full, and on Android what it is plugged into. An iOS simulator has no battery and says so rather than giving a number.

Read-only: readOnlyHint is true.

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).

Examples​

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

Read the battery​

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "app_battery",
    "arguments": {}
  }
}

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

42%, discharging, not plugged in

mobium battery on an Android 15 emulator

mobium battery on an Android 15 emulator