Skip to content
MCP server

Agent Droid Bridge

MCP server giving AI agents eyes and hands inside Android devices via ADB

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.6.1
Listing updated
5 days ago

About Agent Droid Bridge

Agent Droid Bridge is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add agent-droid-bridge -- uvx agent-droid-bridge

Add to claude_desktop_config.json

{
  "mcpServers": {
    "agent-droid-bridge": {
      "command": "uvx",
      "args": [
        "agent-droid-bridge"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "agent-droid-bridge": {
      "command": "uvx",
      "args": [
        "agent-droid-bridge"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "agent-droid-bridge": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "agent-droid-bridge"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agent-droid-bridge": {
      "command": "uvx",
      "args": [
        "agent-droid-bridge"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "agent-droid-bridge": {
      "command": "uvx",
      "args": [
        "agent-droid-bridge"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • ADB_EXECUTION_MODESecurity mode. 'unrestricted' allows all shell commands with an optional denylist. 'restricted' allows only commands in ADB_SHELL_ALLOWLIST.
  • ADB_ALLOW_SHELLSet to 'false' to block all adb shell commands regardless of execution mode.
  • ADB_PATHPath to the ADB binary. Use a full path if adb is not on your system PATH.
  • ADB_EXTRA_TOOL_PACKSComma-separated list of extra tool packs to load. Set to 'app_manager' to enable 9 additional app management tools.
  • ADB_DENIED_TOOLSComma-separated list of tool names to hide from the agent at startup.
  • ADB_SHELL_ALLOWLISTComma-separated list of shell commands permitted in restricted mode. Empty blocks all shell commands.
  • ADB_SHELL_DENYLISTComma-separated list of shell commands blocked in unrestricted mode.
  • MCP_LOG_ENABLEDSet to 'true' to enable session logging. Requires MCP_LOG_DIR.
  • MCP_LOG_DIRAbsolute path to the directory where session logs are written. Required when MCP_LOG_ENABLED is true.
  • ADB_LOG_LEVELServer process log level.
  • ADB_COMMAND_TIMEOUTMaximum seconds to wait for any ADB command.
  • ADB_SCREENSHOT_TIMEOUTMaximum seconds to wait for a screenshot capture.
  • ADB_UI_CHANGE_TIMEOUTDefault timeout in seconds for detect_ui_change.
  • ADB_UI_CHANGE_POLL_INTERVALHow often in seconds detect_ui_change polls the UI hierarchy.
  • ADB_AAPT_TIMEOUTMaximum seconds to wait for aapt dump badging, used by the app_manager pack.
  • ADB_CONFIG_SOURCESet to 'yaml' to load configuration from adb_config.yaml instead of environment variables.

Pricing

Open source

Agent Droid Bridge FAQ

Is Agent Droid Bridge free?

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

How do I add Agent Droid Bridge to Claude Code?

Run this command in your terminal: claude mcp add agent-droid-bridge -- uvx agent-droid-bridge

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers