Skip to content
MCP server

Mobile Agent Harness

MCP server and CLI for driving Android phones over adb, for AI agents and developers

Pricing
Open source
Platforms
CLI, API, Linux
Version
0.5.0
Listing updated
today

Similar MCP servers

About Mobile Agent Harness

Mobile Agent Harness is an open-source MCP server for developer tools. It is available on CLI, API, Linux, macOS, Windows and self-hosted.

The README describes this as a base runtime that gives AI agents control of an Android device through adb, with no app needing to be installed on the phone. It sits on a uiautomator2 bridge and exposes its tools through an MCP server, a command-line interface and a plugin system.

Agents work against the live accessibility tree rather than screen coordinates. Element handles and selector strings such as text or resource-id matches let a model click, type, scroll and read screens, and tool results come back in a consistent envelope that signals business-level failures so the agent can adapt instead of retrying blindly. Optional OCR and vision modes cover canvas-drawn interfaces.

The project is aimed at developers, testers and people automating their own devices. The README points to per-app harness files and a separate community knowledge catalog for app-specific context, and it warns that messaging, banking and shopping apps with anti-automation controls are unreliable over this route.

What it does

Accessibility-tree selectors
Targets elements by resource id, text, class or description instead of fixed screen coordinates.
No device-side app
Connects over adb with USB debugging, so nothing needs installing on the phone.
Hot-reloadable plugins
Plugins in a plugins folder register tools at load time and reload when files change.
Screen evidence and OCR
Combines the accessibility tree with OCR and frame capture for canvas-drawn screens.
Per-app harness files
Declares app flows as selector steps with pre- and postconditions for repeatable runs.
Configurable vision endpoint
Can route visual analysis to an external OpenAI-compatible model endpoint.

Good for

  • Automating repetitive taps and checks on a development or test Android device
  • Letting an AI agent navigate Android settings or apps through an MCP client
  • Capturing screen state and logs to debug mobile app flows
  • Building reusable per-app automation flows with selector-based steps

Pricing

Open source

Free and open source under the MIT license; self-hosted.

Mobile Agent Harness FAQ

Does the phone need an app installed?

The README says no device-side app is required; it works over adb with USB debugging enabled.

What does it require to run?

Python 3.9 or newer and adb on the PATH, with USB debugging turned on for the device.

Which apps is it unreliable on?

The README notes that messaging, banking and e-commerce apps with active anti-automation risk control make the adb tier unreliable.

What license is it under?

The README states the project is released under the MIT license.

Is Mobile Agent Harness free?

Yes. Mobile Agent Harness is open source, so you can use and self-host it for free.

What are the best alternatives to Mobile Agent Harness?

The closest alternatives to Mobile Agent Harness are Mobai MCP, adb-mcp: Android emulator and device control over adb, MCP Test Utils, Oh My Android and NexusAndroid.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.

How AIPoweredBot checks servers