auto-mobile

MCP.Pizza Chef: kaeawc

AutoMobile enables your AI assistant to interact directly with mobile apps on Android and iOS devices. It lets you explore app user experience, reproduce bugs, create UI tests by describing scenarios, and measure performance. Designed for developers, it uses standard mobile tools and libraries to provide fast, accurate automation. You run it on macOS or Linux, integrating with AI agents that support the MCP protocol. No API keys or external accounts are needed, but setup requires developer skills.

Other

Use This MCP server To

Explore app user experience by navigating and mapping screens Reproduce bugs from reports with exact steps and screenshots Create automated UI tests from plain English descriptions Measure app startup time for performance analysis Check scrolling smoothness and frame drops Audit color contrast for accessibility compliance Verify tap target sizes meet guidelines

README

AutoMobile

Pull Request On Merge Nightly License

Platform: macOS Platform: Linux

TypeScript tests: 11,200 Kotlin tests: 2,780 Swift tests: 1,007 Kotlin coverage Swift coverage

AutoMobile sticker

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 An AI agent navigating to the Clock app, creating a new alarm

Searching YouTube for a video 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
Audit contrast Find accessibility issues with color contrast
Check tap targets Ensure touch targets meet size guidelines

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 you can read and follow the step-by-step manual 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

auto-mobile FAQ

Can I use this to automate tasks on my Android or iOS device?
Yes — AutoMobile lets an AI control your mobile apps to explore UX, reproduce bugs, and run tests on Android and iOS devices.
Can I use this to create automated UI tests by describing scenarios in plain English?
Yes — you describe test scenarios simply, and it generates executable test plans for your mobile apps.
Which apps or platforms does AutoMobile work with?
It works with Android and iOS apps by using standard tools like adb and simctl along with Kotlin and Swift libraries.
Do I need an API key or account to use AutoMobile?
No — it is open source and runs locally with your mobile devices; no external account is required.
How hard is it to set up AutoMobile?
Setup requires developer skills, including running scripts and configuring developer tools on macOS or Linux.
Can I use AutoMobile with popular AI models like OpenAI, Claude, or Gemini?
Yes — it is designed to integrate with various AI agents that support the MCP protocol, including those models.