Adbfriend MCP Server

ADB Friend is a tiny cli tool, which helps you to manage your Android device via ADB. Its features were mostly designed for developers, but it can be

Local serverstdio

What is the Adbfriend MCP server?

ADB Friend is a tiny cli tool, which helps you to manage your Android device via ADB. Its features were mostly designed for developers, but it can be useful for everyone. The adbfriend mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 14 defined tools rather than through you.

What it actually does

  • Sync files from your computer to your phone
  • Designed for test data, skipping existing files on device
  • Configure device for tests
  • Disable animations, Enable touches, ..
  • Uninstall apps by pattern
  • Packages command

Its toolset

Everything the assistant can do here goes through one of these:

  • check-adb-speed — Checks the USB connection speed of an Android device for the provided serial
  • clear-installed-package — Clears the package data for provided package names on an Android device
  • set-immersive-full-for-package — Sets the 'immersive-full' flag for provided package names on an Android device
  • force-stop-process — Forces the stop of provided package names on an Android device
  • uninstall-package — Uninstalls provided package names on an Android device
  • get-connected-devices — Retrieves information about all connected Android devices including serial, model, and state
  • get-installed-packages — Retrieves information about all installed packages on an Android device. Supports filtering for third-party apps only
  • list_allowed_directories — Lists directories that are allowed to be accessed by the file system tools
  • list-files — Lists files and directories on an Android device. Supports recursive listing with the 'recursive' option
  • read-file — Reads the content of a file on an Android device
  • read_multiple_files — Reads the contents of multiple files on an Android device at once (reduces LLM calls)
  • write-file — Writes content to a file on an Android device

Configuration

You will need one environment variable: ANDROID_HOME. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Adding it to your client

Installation goes through your MCP client rather than a global install: point it at @modelcontextprotocol/inspector on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

When to reach for it

Plenty of file and storage access servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Adbfriend's toolset — check-adb-speed, clear-installed-package, set-immersive-full-for-package and 11 more — is a fair guide to whether it matches your workflow. It is maintained by mikepenz; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Adbfriend.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the adbfriend mcp server does with a few real requests.

Available tools

ToolWhat it does
check-adb-speedChecks the USB connection speed of an Android device for the provided serial.
clear-installed-packageClears the package data for provided package names on an Android device.
set-immersive-full-for-packageSets the 'immersive-full' flag for provided package names on an Android device.
force-stop-processForces the stop of provided package names on an Android device.
uninstall-packageUninstalls provided package names on an Android device.
get-connected-devicesRetrieves information about all connected Android devices including serial, model, and state.
get-installed-packagesRetrieves information about all installed packages on an Android device. Supports filtering for third-party apps only.
list_allowed_directoriesLists directories that are allowed to be accessed by the file system tools.
list-filesLists files and directories on an Android device. Supports recursive listing with the 'recursive' option.
read-fileReads the content of a file on an Android device.
read_multiple_filesReads the contents of multiple files on an Android device at once (reduces LLM calls).
write-fileWrites content to a file on an Android device.
create-directoryCreates a directory on an Android device.
deleteDeletes a file or directory on an Android device.

How to install the Adbfriend MCP server

{
  "mcpServers": {
    "adbfriend": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/inspector"],
      "env": {
        "ANDROID_HOME": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
ANDROID_HOMEConfiguration value read at startup.Optional

Example prompts to try

  • Use Adbfriend to check-adb-speed.
  • Use Adbfriend to clear-installed-package.
  • Use Adbfriend to set-immersive-full-for-package.

Frequently asked questions

It connects Adbfriend to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (check-adb-speed, clear-installed-package, set-immersive-full-for-package, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Adbfriend directly.