Androidbuild MCP

Launch an app by application id (resolves the launcher activity automatically).

List available Android Virtual Devices and which ones are currently running.

List connected devices and emulators with serial, state, model, Android version and API level.

List modules declared in settings.gradle(.kts) of the project.

List build variants of a module by inspecting its Gradle assemble tasks (runs './gradlew <module>:tasks').

Long-press the screen at coordinates. Instead of pixels you can pass screen percentages (0-1): safer when estimating positions from a screenshot image.

Start recording the device screen (adb screenrecord, max 3 minutes). Returns a recordingId for record_video_stop.

Stop a screen recording and pull the MP4 to the local machine.

Create a new minimal Jetpack Compose app project (single module, version catalog, Gradle wrapper included) ready to build with build_app.

Take a screenshot of the device/emulator screen and return it as an image. With annotate: true (needs the Google android CLI), UI elements get numbered bounding boxes — including text inside images/WebViews that snapshot_ui cannot see.

Scroll the screen in a direction (computes a safe swipe in the middle of the screen, avoiding the status bar and navigation areas). Prefer this over raw swipe for scrolling.

Clear all session defaults, or only the listed keys.

Set default projectDir/module/variant/serial/appId used by other tools when the corresponding argument is omitted. Set these once after discovering the project.

Show the current session defaults.

Switch a device/emulator between dark and light mode (cmd uimode night).

Set the GPS location of a running emulator.

Show toolchain versions: Gradle (from wrapper properties) and everything in the version catalog (AGP, Kotlin, Compose, ...).

Dump the current UI as a compact list of actionable elements (text, id, content-desc, tap coordinates). Use the @(x,y) centers with tap/long_press. Text-heavy screens are capped; pass 'filter' to search within them.

Start capturing logcat to a file in the background. Filter by app (via its pid) and/or tag. Returns a sessionId for stop_log_capture. The app must be running to filter by appId.

Enable clean status bar for screenshots (fixed clock, full battery, full signal) or disable it.

Force-stop a running app (am force-stop).

Stop a log capture session and return the file path plus the last lines.

Swipe from one point to another (scrolling, dismissing). For drag-and-drop use drag instead. Instead of pixels you can pass screen percentages (0-1): safer when estimating positions from a screenshot image.

Tap the screen. Coordinates from snapshot_ui are exact device pixels — prefer them over estimating positions by looking at a screenshot image. Instead of pixels you can pass screen percentages (0-1): safer when estimating positions from a screenshot image.

Tap element #N from the most recent screenshot { annotate: true } capture — no coordinate math needed. The mapping is exact even if your client displays the image scaled. Re-capture after the UI changes: element numbers go stale.

Type ASCII text into the focused field. Waits for the soft keyboard first, so it is safe to call right after tapping a field. Options: clear the field first, press ENTER after. Non-ASCII characters are not supported by adb input.

Uninstall an app from a device/emulator.

Poll the UI until an element containing the given text / content-desc / resource-id appears. Returns its tap coordinates.