android-emulator-mcp
Allows managing local Android Virtual Devices (AVDs), including creating, starting, stopping, and deleting emulators, as well as monitoring and setting hardware sensor data like acceleration and gyroscope.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
android-emulator-mcp
MCP server for managing local Android emulators (AVDs). Companion to adb-mcp — this project handles emulator lifecycle, while adb-mcp handles device interaction.
How it works
Claude Code ←→ android-emulator-mcp ←→ Android SDK tools (emulator, avdmanager, sdkmanager)
↓
Local Android Emulator
↓
adb-mcp (device interaction)Related MCP server: replicant-mcp
Prerequisites
Install the Android command-line tools (requires Java):
brew install --cask temurin # or any other JDK
brew install --cask android-commandlinetools
brew install --cask android-platform-toolsHomebrew installs platform-tools separately from the SDK root, but the emulator expects them together. Create a symlink:
ln -s /opt/homebrew/Caskroom/android-platform-tools/*/platform-tools \
/opt/homebrew/share/android-commandlinetools/platform-toolsSet ANDROID_HOME in your shell:
export ANDROID_HOME="/opt/homebrew/share/android-commandlinetools"Setup
Add to your Claude Code MCP settings (~/.claude/settings.json):
{
"mcpServers": {
"android-emulator": {
"command": "uvx",
"args": ["android-emulator-mcp"]
}
}
}Or install locally for development:
{
"mcpServers": {
"android-emulator": {
"command": "uv",
"args": ["run", "--directory", "/path/to/android-emulator-mcp", "android-emulator-mcp"]
}
}
}Tools
Tool | Description |
| List all existing AVDs with their details |
| Create a new AVD (auto-installs system image) |
| Delete an existing AVD |
| Start an AVD and wait for boot |
| Stop a running emulator |
| Check which emulators are running |
| List available and installed system images |
| List all available sensors and their status |
| Get current values for a sensor |
| Set sensor values (acceleration, gyroscope, etc.) |
Usage examples
"Create an Android emulator and start it"
"List my existing emulators"
"Start the test emulator headless"
"What system images do I have installed?"
"Stop all running emulators"
"Set the accelerometer to simulate the phone lying flat"
"What sensors are available on the emulator?"
Development
# Install dependencies
uv sync
# Run the server locally
uv run android-emulator-mcp
# Run tests
uv run pytestLicense
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for Appcircle mobile CI/CD platform.
MCP server for building and testing AI agents with multi-model experimentation and insights.
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
Build, test, publish and manage real MCP servers from APIs with a live developer studio.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server for automating virtual or physical Android devices using the Gbox SDK. It enables users to manage app installations, capture screenshots, and perform complex UI actions through natural language instructions.9MIT
- AlicenseBqualityDmaintenanceAn MCP server that enables AI assistants to build, test, and debug Android applications by interacting directly with the Android development environment. It provides tools for managing emulators, executing Gradle tasks, running ADB commands, and performing UI automation via accessibility trees.1480 npm20MIT
- FlicenseNot gradedqualityDmaintenanceA powerful MCP server that provides comprehensive Android device automation capabilities through ADB, enabling AI agents to interact with Android devices for testing, automation, and device control tasks.1-
- FlicenseNot gradedqualityDmaintenanceControls Android emulators from any MCP-capable client via ADB and emulator CLI, supporting AVD management, APK operations, screen interactions, and device diagnostics.1-