AutoMobile
Mobile device interaction automation via MCP
AutoMobile
AutoMobile lets AI agents control your mobile devices using natural language. Tell an AI what you want to do, and it interacts with your Android or iOS app.
It can do all this by being an MCP server that uses standard platform tools like adb & simctl paired with additional Kotlin & Swift libraries and apps. All components are open source. The point is to provide mobile engineers with AI workflow tools to perform UX deep dives, reproduce bugs, and run automated tests.
An AI agent navigating to the Clock app, creating a new alarm
An AI agent searching YouTube and browsing results
Explore and Test
| Task | What it does |
|---|---|
| Explore app UX | Navigate your app, discover screens, map user flows, identify confusing interactions |
| Reproduce bugs | Paste a bug report and get exact reproduction steps with screenshots |
| Create UI tests | Describe test scenarios in plain English, get executable test plans |
| Measure startup time | Profile cold and warm launch performance |
| Check scroll performance | Detect jank and dropped frames |
How it works
- 🤖 Fast UX Inspection Kotlin Accessibility Service and Swift XCTestService to enable fast, accurate observations. 10x faster than the next fastest observation toolkit.
- 🦾 Full Touch Injection Tap, Swipe, Pinch, Drag & Drop, Shake with automatic element targeting.
- ♻️ Tool Feedback Observations drive the interaction loop for all tool calls.
- 🧪 Test Execution Kotlin JUnitRunner & Swift XCTestRunner execute tests natively handling device pooling, multi-device tests, and automatically optimizing test timing.
Get Started
You can use our interactive installer to step through all host platform requirements and configuration options. It checks host dependencies, optionally downloads Android or iOS developer tools, and configured the MCP daemon.
curl -fsSL https://raw.githubusercontent.com/kaeawc/auto-mobile/refs/heads/main/scripts/install.sh | bash
Prefer Homebrew for the CLI:
brew install kaeawc/tap/auto-mobile
or follow the installation guide.
Documentation
- Full Documentation - Complete guide with examples
- FAQ - Common questions answered
- Design Docs - Architecture and implementation details
Contributing
- Code of Conduct
- Please report security vulnerabilities via GitHub
- Contributing
Installation
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y @kaeawc/auto-mobileSet up in your AI client
Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"dev-jasonpearson-auto-mobile": {
"command": "npx",
"args": [
"-y",
"@kaeawc/auto-mobile"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referencePackage
@kaeawc/auto-mobilenpmCompatible MCP Clients
AutoMobile works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
- Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect. - Cursor
~/.cursor/mcp.jsonRestart Cursor for changes to take effect. - VS Code
.vscode/mcp.jsonReload VS Code window for changes to take effect. - Windsurf
~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect. - Claude Code
.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.