ADB Friend

by mikepenz

73 stars

399 downloads

Not rated

GitHub

About

Android ADB CLI tool including integrated MCP Server with common adb actions used during development

Details

Author: mikepenz
GitHub stars: 73
Downloads: 399
Categories: Developer Tools, Other, Infrastructure, AI

- Sync files from computer to phone, skipping existing files
- Configure device for tests (disable animations, enable touches, etc.)
- Uninstall apps by pattern
- Apply immersive flag, force-stop, clear app data & cache
- Check USB connection speed with adb-speed tool
- Provides an MCP server with 18 file and device management tools

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name ADB Friend

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "adb friend": {
            "adbfriend": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "adb friend": {
            "adbfriend": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "adb friend": {
            "adbfriend": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "adb friend": {
            "adbfriend": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "adb friend": {
            "adbfriend": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "adb friend": {
            "adbfriend": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "adb friend": {
            "adbfriend": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "adb friend": {
            "adbfriend": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "adb friend": {
            "adbfriend": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "adb friend": {
            "adbfriend": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "adb friend": {
            "adbfriend": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "adb friend": {
            "adbfriend": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "adb friend": {
            "adbfriend": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "adb friend": {
            "adbfriend": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "adb friend": {
            "adbfriend": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

From the repository

Install via Homebrew (brew install mikepenz/tap/adbfriend) or download prebuilt binaries. Use adbfriend --help for an overview of CLI commands. For the MCP server, configure the tool with a JSON entry specifying the command, arguments, and optional ANDROID_HOME environment variable.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "adb friend": {
            "adbfriend": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector"
                ]
            }
        }
    }
}

McpServers

{
    "adbfriend": {
        "command": "npx",
        "args": [
            "@modelcontextprotocol/inspector"
        ]
    }
}

ADB Friend

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.

Features

- 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
- Apply the immersive flag to all packages matching glob, force-stop, clear app data & cache
- Extra tools
- adb-speed (Helps to identify sub-par cables)
- Model Context Protocol MCP Server

Install

The installation can be performed using Homebrew. First you'll require the custom tap:

brew tap mikepenz/tap

Next, install the AdbFriend CLI:

brew install mikepenz/tap/adbfriend

Alternatively, you can download prebuild binaries for release page.

Usage

ADB Friend is a command line tool, which can be used in a terminal.

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

ADB Friend

Features

Install

Usage

Install

More like this

Sequential Thinking

Sentry

Github

Filesystem

EverArt

Google Drive