AutoMobile — Claude Code MCP server for Android and iOS control
An MCP server that lets an AI agent drive your Android or iOS device: tap, swipe, launch apps and watch the screen.
claude mcp add auto-mobile -- npx -y @kaeawc/auto-mobileWhat AutoMobile does
AutoMobile runs as an MCP server on top of the platform's own tools — adb on Android and simctl on iOS. Kotlin and Swift libraries and apps sit alongside them: Kotlin Accessibility Service and Swift XCTestService feed the agent fast screen observations, while Kotlin JUnitRunner and Swift XCTestRunner run tests on the device itself, with device pooling and multi-device runs.
Through the MCP tools the agent can tap, swipe, pinch, drag and drop, and shake, targeting elements automatically. Observations close the loop: every tool call builds on what the previous one returned.
The interactive installer walks through host requirements, optionally pulls Android or iOS developer tools, and configures the MCP daemon. There is a one-line curl install and a Homebrew CLI. If adb or simctl is not on your PATH, the server cannot reach a device — check that before wiring anything up.
What it helps with
- map an app's screens and user flows by walking through them
- turn a bug report into exact reproduction steps with screenshots
- convert a plain-English test scenario into an executable test plan
- profile cold and warm app launch times
- spot jank and dropped frames during scrolling
Example prompts for the agent
- Open the app and show me which screens live under settings
- Reproduce this bug report and attach a screenshot for each step
- Run through the checkout flow and write down a test plan
How to install AutoMobile
Platform CLI
claude mcp add auto-mobile -- npx -y @kaeawc/auto-mobilePlatform CLI
codex mcp add automobile -- npx -y @kaeawc/auto-mobileConfig file
{
"mcpServers": {
"automobile": {
"command": "npx",
"args": [
"-y",
"@kaeawc/auto-mobile"
]
}
}
}Config file
{
"servers": {
"automobile": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@kaeawc/auto-mobile"
]
}
}
}Platform CLI
gemini mcp add automobile npx -y @kaeawc/auto-mobileStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about AutoMobile
How do I install AutoMobile in Claude Code?
Run claude mcp add auto-mobile -- npx -y @kaeawc/auto-mobile. Then check the MCP server list to confirm it connected.
What does AutoMobile do?
It gives an AI agent control over an Android or iOS device: tapping, swiping, dragging elements, running tests and observing the screen. It works on top of adb and simctl.
What do I need for it to work?
The platform tools adb for Android and simctl for iOS, plus the Kotlin and Swift libraries and apps from the repository. The interactive installer checks host dependencies and sets up the MCP daemon.
