ADB MCP Server
About
Interact with Android devices using the Android Debug Bridge (ADB).
Details
- Author
- srmorete
- Categories
- Developer Tools, Other
Jump to
Setup
Install ADB MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/srmorete/adb-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
Quite surprised that this repo reached 50 stars (!) the ecosystem is quite generous sometimes, thank you for starring it!
I've been working on something that is faster, more scalable and also works with iOS, take a look atmobile-device-mcp.
An MCP (Model Context Protocol) server for interacting with Android devices through ADB. This TypeScript-based tool provides a bridge between AI models and Android device functionality.
- 📱 Device Management - List and interact with connected Android devices
- 📦 App Installation - Deploy APK files to connected devices
- 📋 Logging - Access device logs through logcat
- 🔄 File Transfer - Push and pull files between device and host
- 📸 UI Interaction - Capture screenshots and analyze UI hierarchy
- 🔧 Shell Command Execution - Run custom commands on the device
- Node.js (v16 or higher recommended, tested with Node.js v16, v18, and v20)
- ADB (Android Debug Bridge) installed and in your PATH
- An Android device or emulator connected via USB or network with USB debugging enabled
- Permission to access the device (accepted debugging authorization on device)
To install ADB Android Device Server for Claude Desktop automatically viaSmithery:
npx -y @smithery/cli install @srmorete/adb-mcp --client claude
# Clone the repository git clone https://github.com/srmorete/adb-mcp.git cd adb-mcp # Install dependencies npm install # Build the TypeScript code npm run build # Run the server npx adb-mcp
The server uses default ADB paths. For custom ADB location:
export ADB_PATH=/path/to/adb npx adb-mcp
{ "mcpServers": { "adb": { "command": "npx", "args": [ "adb-mcp" ] } } }
IMPORTANT: The server must be running before using any ADB tools.
[INFO] ADB MCP Server connected and ready
Keep this terminal window open while using the ADB tools.
All tools are available with the following naming convention:
- adb_devices- List connected devices
- adb_shell- Execute shell commands on a device
- adb_install- Install an APK file using a local file path
- adb_package_manager- Execute Package Manager (pm) commands - list packages, grant/revoke permissions, manage apps
- adb_activity_manager- Execute Activity Manager (am) commands - start activities, broadcast intents, control app behavior
- adb_logcat- View device logs with optional filtering
- adb_pull- Pull files from a device
- adb_push- Push files to a device
- dump_image- Take a screenshot of the current screen
- inspect_ui- Get UI hierarchy in XML format (most useful for AI interaction)
- Ensure the server is running (npx adb-mcp)
- Check server output for error messages
- Try detailed logs:LOG_LEVEL=3 npx adb-mcp
- Kill hanging processes:
- ps aux | grep "adb-mcp" | grep -v grep
- thenkill -9 [PID]
- Verify connection withadb_devices
- If "unauthorized", accept debugging authorization on device
- Check USB/network connections
- Try restarting ADB:adb kill-server && adb start-server
- Use an emulator (it was built using one), for real devices maybe try this:
- Ensure USB debugging is enabled
- For newer Android versions, enable "USB debugging (Security settings)"
- Try different USB port or cable
- or let me know in an issue
- Android 8.0 and higher
- MCP clients including Claude in Cursor IDE
- Was built on macOS butshouldrun on any POSIX compatible (Linux etc).
- Did not try on Windows butmaybeit works.
- Contributions are welcome! Submit a Pull Request.
- For major changes, open an issue to discuss first.
- You can, of course, also fork it
- Note:this project wasvibe-codedso if you spot some weird stuff... well now you know 🙂
This project is licensed under the MIT License - see theLICENSEfile for details.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Drives an Android emulator or a real device over adb: screenshots, UI hierarchy with true device-pixel coordinates, tap and type, app lifecycle, logcat, and Gradle builds and tests.
Control Android devices via the Android Debug Bridge (ADB).
An agentic toolkit to control, debug, and profile iOS and Android apps.
The deepest Android Debug Bridge MCP server — 147 tools from UI to baseband.
MCP server which expose Android's app runtimes to coding agents.
A plugin-based MCP server for React Native runtime debugging, inspection, and automation. Connects to Metro bundler via Chrome DevTools Protocol — no app code changes needed for most features.
Turn natural language into powerful Perfetto trace analysis. Quickly explain jank, diagnose ANRs, spot CPU hot threads, uncover lock contention, and find memory leaks.
Enables AI assistants like Claude Code to capture logs, execute code, inspect state, and control navigation in your React Native app.
Connects to the React Native application debugger to retrieve console logs from Metro.
Build, test, and debug mobile and desktop apps with the Tauri framework faster with automated UI interaction, screenshots, DOM state, and console logs from your app under development.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
