app_install

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

Install an app from a local .apk (Android) or .app bundle (iOS).

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

Arguments

Name	Type	Required	What it is
content	string		The app itself, base64, instead of a path: a .apk, or a .app directory as a .tar.gz. For a daemon on another machine; the CLI and pipe send it from a path.
device	string		Device serial to target, e.g. "emulator-5554". Omit when only one device is running.
driver	string: uiautomator2, uiautomator, wda		Driver 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).
name	string		With content: the file's name, such as "app.apk" or "MobiumApp.app.tar.gz".
path	string		Local path to the .apk or .app.

Examples

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

Install an app from a file

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "app_install",
    "arguments": {
      "path": "./build/app-debug.apk"
    }
  }
}