adbfriend

Overview

ADB Friend is a compact CLI tool that enables Android device management through ADB commands. Since version 1.4.0, it has included a Model Context Protocol (MCP) server that exposes numerous tools for interacting with Android devices. The server allows AI assistants to perform actions like file transfer, app management, system configuration, and device debugging. It provides comprehensive functionality for both developers and advanced Android users.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• check-adb-speed

  Checks the USB connection speed of an Android device

  Try:Check the USB connection speed of my Android deviceTry:Is my USB connection fast enough for file transfers?
• clear-installed-package

  Clears the package data for provided package names

  Try:Clear data for the 'sample' appTry:Reset cache and data for com.example.app
• force-stop-process

  Forces the stop of provided package names

  Try:Force stop the 'sample' appTry:Kill the process for com.example.app
• uninstall-package

  Uninstalls provided package names from the device

  Try:Uninstall the 'sample' appTry:Remove com.example.app from my device
• get-connected-devices

  Retrieves information about all connected Android devices

  Try:Show me all connected devicesTry:List Android devices attached to this computer
• get-installed-packages

  Retrieves information about installed packages on a device

  Try:Show all installed appsTry:List third-party packages on my device
• list-files

  Lists files and directories on an Android device

  Try:List files in the Download folderTry:Show all files on /sdcard
• read-file

  Reads the content of a file on an Android device

  Try:Read the content of /sdcard/config.jsonTry:Show me the logcat file
• write-file

  Writes content to a file on an Android device

  Try:Write 'test data' to /sdcard/test.txtTry:Create a config file with settings
• search-files

  Searches for files matching a pattern within allowed directories

  Try:Find all .pdf files in the Download folderTry:Search for images with pattern IMG_*
• copy-file-to-host

  Copies a binary file from the Android device to the host system

  Try:Copy logcat.txt to my computerTry:Pull the screenshot.png from the device
• install-apk

  Installs an APK on the Android device from the host system

  Try:Install app.apk from my computerTry:Load the new APK onto my device

Comparable tools

Installation

brew tap mikepenz/tap
brew install mikepenz/tap/adbfriend

{
  "mcpServers": {
    "adb-friend": {
      "command": "/opt/homebrew/bin/adbfriend",
      "args": [
        "mcp",
        "server"
      ],
      "env": {
        "ANDROID_HOME": "/path/to/your/android/sdk"
      }
    }
  }
}

FAQ

What is required for the MCP server to work?

The server requires either the ANDROID_HOME environment variable to be set or an adb-server to be manually running on your machine.

How can I debug the MCP server?

Use 'npx @modelcontextprotocol/inspector' to debug the server. Start the server with 'adbfriend mcp server --sse true' (default port 3001).

Compare adbfriend with