Back to the catalog

AutoMobile

Mobile device interaction automation via MCP

Open source Open in the app JSON README (API)

About

Mobile device interaction automation via MCP

Details

Kind
MCP servers
Topic
No topic detected
Publisher
dev.jasonpearson
Origin
official
Category
ferramentas
Transport
local
Version
0.0.67
Stars
46
Forks
5
Open pull requests
11
Last push
2026-09-08T12:33:00Z
Repository state
ativo
Language
TypeScript
License
Apache-2.0
Added
2026-08-29 03:01:30
Updated
2026-08-30 23:00:07
Origin id
dev.jasonpearson/auto-mobile

README

# AutoMobile

[![Pull Request](https://github.com/kaeawc/auto-mobile/actions/workflows/pull_request.yml/badge.svg)](https://github.com/kaeawc/auto-mobile/actions/workflows/pull_request.yml)
[![On Merge](https://github.com/kaeawc/auto-mobile/actions/workflows/merge.yml/badge.svg)](https://github.com/kaeawc/auto-mobile/actions/workflows/merge.yml)
[![Nightly](https://github.com/kaeawc/auto-mobile/actions/workflows/nightly.yml/badge.svg)](https://github.com/kaeawc/auto-mobile/actions/workflows/nightly.yml)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)

![Platform: macOS](https://img.shields.io/badge/platform-macOS-lightgrey)
![Platform: Linux](https://img.shields.io/badge/platform-Linux-lightgrey)

![TypeScript tests: 14,006](https://img.shields.io/badge/TypeScript_tests-14%2C006-3178C6)
![Kotlin tests: 3,298](https://img.shields.io/badge/Kotlin_tests-3%2C298-7F52FF)
![Swift tests: 1,195](https://img.shields.io/badge/Swift_tests-1%2C195-F05138)
![Kotlin coverage](https://img.shields.io/endpoint?url=https://kaeawc.github.io/auto-mobile/kotlin-coverage-badge.json)
![Swift coverage](https://img.shields.io/endpoint?url=https://kaeawc.github.io/auto-mobile/swift-coverage-badge.json)

![AutoMobile sticker](docs/img/auto_mobile_sticker_splash.png)

**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.

![Setting an alarm in the Clock app](docs/img/clock-app.gif)
_An AI agent navigating to the Clock app, creating a new alarm_

![Searching YouTube for a video](docs/img/youtube-search.gif)
_An AI agent searching YouTube and browsing results_

### Explore and Test

| Task                                                         | What it does                                                                         |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
| **[Explore app UX](docs/using/agent-examples.md)**           | Navigate your app, discover screens, map user flows, identify confusing interactions |
| **[Reproduce bugs](docs/using/agent-examples.md)**           | Paste a bug report and get exact reproduction steps with screenshots                 |
| **[Create UI tests](docs/using/ui-tests.md)**                | Describe test scenarios in plain English, get executable test plans                  |
| **[Measure startup time](docs/using/agent-examples.md)**     | Profile cold and warm launch performance                                             |
| **[Check scroll performance](docs/using/agent-examples.md)** | 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](docs/design-docs/mcp/interaction-loop.md) drive the interaction loop for all [tool calls](docs/tools.md).
- 🧪 **Test Execution** [Kotlin JUnitRunner](docs/design-docs/plat/android/junit-runner/index.md) & [Swift XCTestRunner](docs/using/ui-tests.md#ios--swift-package-manager) 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.

```bash title="One-line install (click to copy)"
curl -fsSL https://raw.githubusercontent.com/kaeawc/auto-mobile/refs/heads/main/scripts/install.sh | bash
```

Prefer Homebrew for the CLI:

```bash title="Homebrew (click to copy)"
brew install kaeawc/tap/auto-mobile
```

or follow the [installation guide](docs/index.md#install).

## Documentation

- **[Full Documentation](docs/index.md)** - Complete guide with examples
- **[FAQ](docs/faq.md)** - Common questions answered
- **[Design Docs](docs/design-docs/index.md)** - Architecture and implementation details

## Contributing

- [Code of Conduct](CODE_OF_CONDUCT.md)
- Please report security vulnerabilities via GitHub
- [Contributing](.github/CONTRIBUTING.md)

More