Which integrations are available for this server?

Provides tools for managing Android devices via ADB and scrcpy, including device management, app installation/uninstallation, file transfer, shell commands, input control, screen mirroring, UI element finding, and system information retrieval.

How do I use android-mcp-server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@android-mcp-server list connected Android devices" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

android-mcp-server

by chldu2000

Overview Schema Source Related Servers Discussions Admin

Python

Local

Android MCP Server

MCP server providing ADB and scrcpy capabilities for Android device control. Built with FastMCP.

Assisted by Minimax Model via Claude Code.

Features

Device Management: List devices, get device info
App Management: Install/uninstall apps, start/stop apps, list packages
File Operations: Push/pull files between device and host
Shell Execution: Run shell commands on device, exec-out for binary output
Input Control: Tap, swipe, input text, press keys
System Info: Screen size, battery status, system properties
Screen Control: Screen mirroring and control via scrcpy, screenshot via exec-out
UI Element Finding: Dump UI hierarchy, find elements by attributes

Related MCP server: MSC MCP Server

Install

uv add android-mcp-server

Or install from source:

# Clone the repo, then install
git clone https://github.com/chldu2000/android-mcp-server.git
cd android-mcp-server
uv pip install -e .
uv run python -m android_mcp.main

Add MCP Server

Claude Code

claude mcp add android uv run -- python -m android_mcp.main --cwd /Path/to/workdir

Other MCP Clients

The server can be run with:

uv run python -m android_mcp.main

Tools

Device Management

Tool	Description
`adb_list_devices`	List all connected Android devices
`adb_device_info`	Get detailed device information

App Management

Tool	Description
`adb_install_app`	Install an APK
`adb_uninstall_app`	Uninstall an application
`adb_list_packages`	List installed packages
`adb_start_app`	Start an application
`adb_stop_app`	Force stop an application

File Operations

Tool	Description
`adb_pull_file`	Pull file from device
`adb_push_file`	Push file to device

Shell

Tool	Description
`adb_shell`	Execute shell command
`adb_exec_out`	Execute command via exec-out (for binary output)

Input Control

Tool	Description
`adb_tap`	Tap at coordinates
`adb_swipe`	Swipe gesture
`adb_input_text`	Input text
`adb_press_key`	Press key event

System Info

Tool	Description
`adb_get_screen_size`	Get screen resolution
`adb_get_battery`	Get battery status
`adb_get_properties`	Get system properties

Screen Control (scrcpy)

Tool	Description
`scrcpy_start`	Start screen mirroring
`scrcpy_stop`	Stop screen mirroring
`scrcpy_screenshot`	Take screenshot
`scrcpy_control`	Send control command
`adb_screencap`	Capture screenshot via exec-out

UI Elements

Tool	Description
`adb_dump_ui_tree`	Dump UI hierarchy tree
`adb_find_element`	Find UI elements by attributes

Device Connection

USB Devices

Connect via USB and ensure USB debugging is enabled on the device.

Network Devices

For TCP/IP connection:

Enable TCP/IP mode on device:
```
adb tcpip 5555
```
Find device IP:
```
adb shell ip route
```
Connect:
```
adb connect <device-ip>:5555
```

Dependencies

fastmcp - MCP server framework
scrcpy - Screen mirroring (must be installed separately)
uiautomator2 - uiautomator2 Python wrapper

Available Tools

25 tools

adb_device_infoC

Get detailed information about a specific device.

Inputs: serial (required).

adb_dump_ui_treeC

Dump the UI hierarchy tree from the device.

Inputs: serial (required).

adb_exec_outC

Execute a command via adb exec-out (for binary output).

Inputs: serial (required), command (required).

adb_find_elementC

Find UI elements by their attributes using uiautomator.

Inputs: serial (required), text, enabled, clickable, +4 more.

adb_get_batteryC

Get battery status of the device.

Inputs: serial (required).

adb_get_propertiesC

Get system properties from the device.

Inputs: serial (required), keys.

adb_get_screen_sizeC

Get the screen resolution of the device.

Inputs: serial (required).

adb_input_textC

Input text on the device.

Inputs: text (required), serial (required).

adb_install_appC

Install an APK on the device.

Inputs: serial (required), apk_path (required).

adb_list_devicesA

List all connected Android devices.

Inputs: no named parameters.

adb_list_packagesC

List all installed packages on the device.

Inputs: serial (required).

adb_press_keyC

Press a key event.

Inputs: serial (required), keycode (required).

adb_pull_fileB

Pull a file from the device to local filesystem.

Inputs: serial (required), local_path (required), device_path (required).

adb_push_fileC

Push a file from local filesystem to the device.

Inputs: serial (required), local_path (required), device_path (required).

adb_screencapC

Capture screenshot using exec-out and save to local file.

Inputs: serial (required), output_path (required).

adb_shellC

Execute a shell command on the device.

Inputs: serial (required), command (required).

adb_start_appC

Start an application on the device.

Inputs: serial (required), package_name (required), activity.

adb_stop_appC

Force stop an application on the device.

Inputs: serial (required), package_name (required).

adb_swipeC

Simulate a swipe gesture.

Inputs: x1 (required), x2 (required), y1 (required), y2 (required), +2 more.

adb_tapC

Simulate a tap at the specified coordinates.

Inputs: x (required), y (required), serial (required).

adb_uninstall_appC

Uninstall an application from the device.

Inputs: serial (required), package_name (required).

scrcpy_controlD

Send control command to scrcpy.

Inputs: action (required), params (required), serial (required).

scrcpy_screenshotC

Take a screenshot from the device.

Inputs: serial (required), output_path.

scrcpy_startC

Start screen mirroring via scrcpy.

Inputs: serial (required), bit_rate.

scrcpy_stopA

Stop screen mirroring.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3/5.0

Scored 2026-07-13 06:10 across 25 tools

Disambiguation5/5

Each tool targets a distinct function, with clear separation between ADB operations and scrcpy mirroring. No two tools have overlapping purposes; even similar actions like screenshots are differentiated by the underlying technology (ADB vs scrcpy).

Naming Consistency5/5

All tools follow a consistent snake_case pattern with a prefix ('adb_' or 'scrcpy_') followed by a verb_noun pair. This uniformity makes it easy for an agent to infer tool roles.

Tool Count4/5

With 25 tools, the server is comprehensive but borders on the high side. However, each tool serves a specific need for Android device management, and the set is well-scoped for its purpose.

Completeness4/5

The tool surface covers core ADB operations, UI interaction, app lifecycle, file transfer, and screen mirroring. Minor gaps like logcat access or screen recording exist but do not significantly hinder typical automation workflows.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Mobilerun
io.github.droidrun
Let AI agents control Android and iOS devices on Mobilerun Cloud: screen, input, apps, workflows.
Testing & QA Tools App Automation
31
https://api.mobilerun.ai/v1/mcp
PreviewAPK
io.github.livetaub
Give your AI agent a real cloud Android phone: push APKs, drive it, get screenshots and logs.
Testing & QA Tools Cloud Platforms Developer Tools
1
https://previewapk.siteport.site/mcp
OmniDebugLink
dev.omnidebuglink
remote debug iOS/Android/Unity/Godot/Flutter/RN/Web on real-device.ui-tree/screenshots/taps,tests.
Developer Tools Testing & QA Tools
1
https://api.omnidebuglink.dev/mcp
OmniDebugLinkA
dev.omnidebuglink.api
Drive real devices from your AI Coding tool. Embed a client SDK (Unity, Godot, Flutter, iOS/macOS, Android, React Native, Web) in your app, then capture screenshots, traverse the UI tree, inject taps and key events, and run automated test tasks on the physical device over a secure relay.
Coding Agents Developer Tools
61
https://api.omnidebuglink.dev/mcp

Related MCP Servers

Android Debug Bridge MCP
Testing & QA Tools App Automation Shell Access
TiagoDanin
A
license
B
quality
C
maintenance
Enables control of Android devices via ADB for automation and testing. Supports app management, screen capture, UI analysis, and input simulation through natural language commands.
Updated 2 months ago (2026-09-03 17:44 UTC)
9
167 npm
38
MIT
MSC MCP Server
OS Automation App Automation Developer Tools
NakanoSanku
F
license
Not graded
quality
D
maintenance
Enables control of Android devices through ADB, allowing users to list connected devices, capture screenshots using multiple methods (adb, droidcast, minicap, mumu), and retrieve device information.
Updated a year ago (2025-11-19 08:23 UTC)
-
android-device-mcp
File Systems Command Line
prashant1507
F
license
B
quality
D
maintenance
Provides comprehensive Android device management capabilities through ADB, including device management, app management, file operations, and system monitoring.
Updated a year ago (2025-08-13 12:26 UTC)
18
1
-
adb_mcp_server
Testing & QA Tools App Automation
wolfcoming
A
license
Not graded
quality
D
maintenance
Enables remote control of Android devices via ADB, including screen operations, input, app management, file transfer, and advanced tools like UI testing and performance analysis.
Updated 2 years ago (2025-03-28 06:13 UTC)
25
MIT

Android MCP Server

Features

Install

Add MCP Server

Claude Code

Other MCP Clients

Tools

Device Management

App Management

File Operations

Shell

Input Control

System Info

Screen Control (scrcpy)

UI Elements

Device Connection

USB Devices

Network Devices

Dependencies

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Android Debug Bridge MCP

MSC MCP Server

android-device-mcp

adb_mcp_server