agent-droid-bridge

Agent Droid Bridge gives AI agents programmatic control over Android devices and emulators via ADB, exposed as an MCP server.

Agent Droid Bridge is an MCP server that connects AI agents to Android devices and emulators over ADB. It is built for mobile automation, app testing, dynamic analysis, and reverse engineering: exposing the full surface of ADB as structured tools that any MCP-compatible AI client can call directly. If ADB can do it, an agent can do it.

Purpose-built tools return structured, minimal responses. No raw XML dumps, no wasted context — agents stay fast across long sessions.

The demo above runs through a few straightforward tasks to show what a connected agent can do, and this is just scratching the surface:

- Installs the Paint app, opens it, and draws a house by calculating pixel coordinates for the walls and roof
- Opens the device browser, searches for "MCP Wikipedia", navigates to the result page, and takes a screenshot
- Opens the Calculator, computes 1337 × 42, and extracts the result to the host machine
- Opens Contacts, creates a new entry with a name and phone number, and confirms it saved
- Opens the Calendar and schedules an appointment for a specific date
- Opens Settings and toggles dark mode
- Extracts the Calculator APK from the device to the host machine
- Installs Notepad, writes a one-sentence summary of every task completed, and takes a final screenshot

- 14 built-in tools for screen capture, UI inspection, text reading, element extraction, touch and swipe input, text entry, keycode events, app launching, ADB commands, and device inspection
- app_managerpack adds 9 tools for package management, app lifecycle, APK extraction, permissions, and intent injection. Load it withADB_EXTRA_TOOL_PACKS=app_manager
- Tool availability is reflected in the server's startup instructions. Agents receive an accurate catalog at connect time

- Auto-detects a single connected device; prompts for selection when multiple devices are present
- Runs over stdio, compatible with any MCP-capable AI client
- Structured responses instead of raw XML dumps, keeping agent context lean across long automation runs

- Two execution modes:unrestricted(full ADB access, optional denylist) andrestricted(allowlist-only, blocks everything not explicitly permitted)
- SetADB_ALLOW_SHELL=falseto disable all shell commands regardless of mode
- Hide specific tools from the agent withADB_DENIED_TOOLS
- All commands parsed viashlex. No shell injection possible

- Optional session recorder logs every tool call, ADB command, and security event to structured JSONL files. Enable withMCP_LOG_ENABLED=trueandMCP_LOG_DIR

Mobile QA and test automationAutomate UI flows across real devices and emulators without modifying the app or writing test code. Tap, swipe, type, read screen content, take screenshots — all from a natural language prompt.

App security researchExtract APKs, inspect declared permissions, fire arbitrary intents, and observe runtime behavior on screen. No instrumentation, no jailbreak required.

Dynamic analysisLaunch apps in controlled states, drive UI interactions, capture screen state at each step, and pull artifacts — all scriptable through an AI agent.

Development and debuggingInstall builds, verify UI states, check app info, and run ADB commands without leaving your coding environment.

No cloning or virtual environments needed. Requires Python 3.11+ and ADB installed on your host.

uvxis provided byuv. If you don't have it:curl -LsSf https://astral.sh/uv/install.sh | sh

To install from source instead, seedocs/setup.md — Option B.

To verify the install:uvx agent-droid-bridge --help
- Install ADB — seedocs/setup.mdfor platform-specific instructions
- Connect an Android device or start an emulator
- Add the server to your MCP client config:

{ "mcpServers": { "agent-droid-bridge": { "command": "uvx", "args": ["agent-droid-bridge"], "env": { "ADB_EXECUTION_MODE": "unrestricted", "ADB_ALLOW_SHELL": "true", "ADB_PATH": "adb", "ADB_EXTRA_TOOL_PACKS": "", "MCP_LOG_ENABLED": "false", "MCP_LOG_DIR": "~/logs/agent-droid-bridge" } } } }

To enable session logging, setMCP_LOG_ENABLEDto"true"and updateMCP_LOG_DIRto a writable path on your machine.
- Prompt your agent to use theagent-droid-bridgeMCP tools

Full setup guide and environment variable reference:docs/setup.md

Optional packs extend the core toolset. Enable them by settingADB_EXTRA_TOOL_PACKSin your MCP client config. Seedocs/extra-tool-packs.md.

Configure the server entirely from your MCP client'senvblock. No files to edit. The env block in the Quick Start above covers the most common settings. For the full reference including security filtering, tool visibility, and timeouts, seedocs/configuration.md.

To use a YAML config file instead, setADB_CONFIG_SOURCE=yaml. Seedocs/configuration.mdfor details.

Session recording is separate. Enable it withMCP_LOG_ENABLED=trueandMCP_LOG_DIR. Full reference:docs/logging.md.

Contributions are welcome. SeeCONTRIBUTING.mdfor guidelines on setup, code standards, and submitting pull requests.

To report a security vulnerability, follow the process inSECURITY.md— do not open a public issue.

An agentic toolkit to control, debug, and profile iOS and Android apps.