npm @kaeawc/auto-mobilestdioApache-2.0updated 8d ago
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.
What can you do with AutoMobile?
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
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
Install
Add AutoMobile to your client. Pick the one you use.
claude mcp add auto-mobile -- npx -y @kaeawc/auto-mobilecodex mcp add auto-mobile -- npx -y @kaeawc/auto-mobileamp mcp add auto-mobile -- npx -y @kaeawc/auto-mobile{
"mcpServers": {
"auto-mobile": {
"command": "npx",
"args": [
"-y",
"@kaeawc/auto-mobile"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"auto-mobile": {
"command": "npx",
"args": [
"-y",
"@kaeawc/auto-mobile"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"auto-mobile","command":"npx","args":["-y","@kaeawc/auto-mobile"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"auto-mobile": {
"command": "npx",
"args": [
"-y",
"@kaeawc/auto-mobile"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"auto-mobile": {
"command": "npx",
"args": [
"-y",
"@kaeawc/auto-mobile"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"auto-mobile": {
"command": "npx",
"args": [
"-y",
"@kaeawc/auto-mobile"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"auto-mobile": {
"type": "local",
"command": "npx",
"args": [
"-y",
"@kaeawc/auto-mobile"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"auto-mobile": {
"command": {
"path": "npx",
"args": [
"-y",
"@kaeawc/auto-mobile"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y @kaeawc/auto-mobileRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Score
39 / 100
Incomplete
- Documentation25/25
- Maintenance25/25
- Trust13/20
- Capability0/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 0 days ago
- Has a release history
- Repository is not archived
- Licensed Apache-2.0
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 0.0.67Latest | Aug 30, 2026 |
| 0.0.66 | Aug 27, 2026 |
| 0.0.65 | Aug 27, 2026 |
| 0.0.64 | Aug 25, 2026 |
| 0.0.63 | Aug 24, 2026 |
| 0.0.62 | Aug 23, 2026 |
| 0.0.61 | Aug 22, 2026 |
| 0.0.60 | Aug 19, 2026 |
| 0.0.59 | Aug 19, 2026 |
| 0.0.58 | Aug 15, 2026 |
| 0.0.57 | Aug 14, 2026 |
| 0.0.56 | Aug 14, 2026 |
| 0.0.55 | Aug 13, 2026 |
| 0.0.53 | Aug 11, 2026 |
| 0.0.52 | Aug 10, 2026 |
| 0.0.51 | Aug 9, 2026 |
| 0.0.50 | Aug 3, 2026 |
| 0.0.49 | Aug 3, 2026 |
| 0.0.48 | Aug 1, 2026 |
| 0.0.47 | Jul 31, 2026 |
| 0.0.13 | Feb 13, 2026 |