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)
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-tools
Homebrew 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-tools
Set 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_avds | List all existing AVDs with their details |
create_avd | Create a new AVD (auto-installs system image) |
delete_avd | Delete an existing AVD |
start_emulator | Start an AVD and wait for boot |
stop_emulator | Stop a running emulator |
emulator_status | Check which emulators are running |
list_system_images | List available and installed system images |
sensor_status | List all available sensors and their status |
sensor_get | Get current values for a sensor |
sensor_set | 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 pytest
License
MIT