Launch App
mobile_launch_appDestructive
Open specific mobile applications on iOS or Android devices by providing the app's package name and device identifier.
Instructions
Launch an app on mobile device. Use this to open a specific app. You can find the package name of the app by calling list_apps_on_device.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| device | Yes | The device identifier to use. Use mobile_list_available_devices to find which devices are available to you. | |
| packageName | Yes | The package name of the app to launch |
Implementation Reference
- src/server.ts:266-279 (registration)Registration of the 'mobile_launch_app' MCP tool, including title, description, input schema (device ID and packageName), and the handler function.
tool( "mobile_launch_app", "Launch App", "Launch an app on mobile device. Use this to open a specific app. You can find the package name of the app by calling list_apps_on_device.", { device: z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you."), packageName: z.string().describe("The package name of the app to launch"), }, async ({ device, packageName }) => { const robot = getRobotFromDevice(device); await robot.launchApp(packageName); return `Launched app ${packageName}`; } ); - src/server.ts:270-273 (schema)Zod input schema for the tool: device (string, device identifier), packageName (string, app package name).
{ device: z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you."), packageName: z.string().describe("The package name of the app to launch"), }, - src/server.ts:274-278 (handler)Inline handler function: retrieves Robot instance for the device via getRobotFromDevice and invokes robot.launchApp(packageName).
async ({ device, packageName }) => { const robot = getRobotFromDevice(device); await robot.launchApp(packageName); return `Launched app ${packageName}`; } - src/android.ts:141-147 (helper)AndroidRobot.launchApp: launches app using 'adb shell monkey -p {packageName} -c android.intent.category.LAUNCHER 1'.
public async launchApp(packageName: string): Promise<void> { try { this.silentAdb("shell", "monkey", "-p", packageName, "-c", "android.intent.category.LAUNCHER", "1"); } catch (error) { throw new ActionableError(`Failed launching app with package name "${packageName}", please make sure it exists`); } } - src/ios.ts:140-143 (helper)IosRobot.launchApp: launches app using go-ios 'launch' command after asserting tunnel.
public async launchApp(packageName: string): Promise<void> { await this.assertTunnelRunning(); await this.ios("launch", packageName); } - src/mobile-device.ts:152-154 (helper)MobileDevice.launchApp: launches app via mobilecli 'apps launch {packageName}' command.
public async launchApp(packageName: string): Promise<void> { this.runCommand(["apps", "launch", packageName]); }