Control real Android and iOS devices with LLM agents β tap, swipe, type, automate flows.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent β or use 1-click editor setup below.
Manual Client & Custom JSON ConfigExpand JSON βΎ
Client Config & Setup
Choose your client or environment
Target File:
π‘ Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Documentation Overview
Mobilerun is an open-source framework for controlling Android and iOS devices with LLM agents.
It gives agents mobile-native tools to inspect UI state, understand screenshots, tap, swipe, type, plan multi-step workflows, and return results through a CLI or Python API.
π Documentation Β· βοΈ Mobilerun Cloud Β· π‘οΈ Mobile Harness
Deutsch | EspaΓ±ol | franΓ§ais | ζ₯ζ¬θͺ | νκ΅μ΄ | PortuguΓͺs | Π ΡΡΡΠΊΠΈΠΉ | δΈζ
- π€ Control Android and iOS devices with natural language commands
- π Use OpenAI, Anthropic, Gemini, xAI, Ollama, DeepSeek, OpenRouter, and OpenAI-compatible models
- π§ Run direct tasks or enable reasoning mode for complex multi-step automation
- π» Automate from the CLI, a terminal UI, Docker, or Python code
- π Extend agents with custom tools, structured output, app cards, and credentials
- πΈ Combine accessibility trees with screenshots for visual understanding
- π« Trace execution with Arize Phoenix or Langfuse
Use the framework when you want to run the agent on your machine. Use Mobilerun Cloud when you want a ready-to-go solution for your local phones or cloud-hosted virtual/physical phones, managed infrastructure, and API-driven device workflows without running the agent on your local machine. Check out our benchmark results.
π¦ Installation
Note: Python 3.14 is not currently supported. Please use Python
>=3.11,<3.14.
Install Mobilerun with uv:
Most LLM providers are included by default. For Anthropic support, install the optional extra:
π Quickstart
Before starting, make sure you have ADB installed and an Android device with Developer options and USB debugging enabled. iOS setup is supported separately through the iOS Portal flow.
1. Install the Portal on your device
This installs the Mobilerun Portal app, enables its accessibility service, and prepares the device for local control.
2. Verify the connection
You should see confirmation that the Portal is installed and accessible.
3. Configure your LLM provider
The wizard walks you through choosing a provider, auth method, and model. You can also use provider environment variables such as GOOGLE_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, XAI_API_KEY, or MINIMAX_API_KEY.
4. Run your first command
Useful run options:
Read the full framework documentation.
βοΈ Features
- CLI: Run one-off natural language tasks, inspect devices, replay macros, and debug from the terminal.
- Python API: Build custom mobile automation workflows with Python and use custom tools.
- Android and iOS support: Control Android through the Portal app or target iOS through the iOS Portal flow.
- Portal-based control: Use UI trees, screenshots, text input, gestures, app launching, and device state from the Portal runtime.
- Vision mode: Send screenshots to the LLM with
--vision, or use screenshot-only control with--vision-only(useful for the apps that do not have a11y tree information). - Reasoning mode: Use
--reasoningfor manager-executor planning on longer or more complex tasks. - Tracing and telemetry: Debug execution with Arize Phoenix, Langfuse, saved trajectories, and detailed logs.
- Structured output: Return structured data from mobile workflows.
- App cards and custom tools: Add app-specific guidance to make agent perform better on your use-cases.
- Docker: Run Mobilerun in a container for repeatable local environments.
βοΈ Framework vs Cloud
| Mobilerun Framework | Mobilerun Cloud | |
|---|---|---|
| Best for | Running agents locally on your own machine and devices | Ready-to-go local phone control, hosted real or virtual devices, API workflows, and managed device operations |
| Runtime | Your machine | Mobilerun-managed infrastructure |
| Interface | CLI, Docker, and Python API | Dashboard, REST API, SDKs, and hosted devices |
Use the framework when you want full local control of the agent runtime. Use Mobilerun Cloud when you want managed devices, fleet workflows, or cloud APIs without running the agent locally. Learn more in the framework overview and the cloud docs.
Which should I choose?
- Choose Mobilerun Framework for local agent execution and code-level control.
- Choose Mobilerun Cloud for managed phones, APIs, and scale without running agents locally.
Cloud Device Types
| Device type | What it is | Best for |
|---|---|---|
| Personal | Your own hardware connected to Mobilerun Cloud | Quick automation on devices you own |
| Cloud Phone (Hosted) | Instantly available cloud-hosted phone | Scalable hosted automation |
| Physical Phone (Hosted) | Real hardware with stronger identity characteristics | Workflows that need high device authenticity and trust |
Automate WhatsApp on a Cloud Phone
Generate leads with Google Maps on a Cloud Phone
𧩠Agent Skill
Give Claude Code, Codex, or another coding agent direct control of Android and iOS devices with the mobile-harness skill. Copy paste it into your agent:
The skill teaches the agent to drive local devices (ADB, Portal, iOS Simulator) and Mobilerun Cloud phones.
π¬ Demo Videos
Book accommodation from a prompt
Shows multi-step navigation, text input, and app-state reasoning while Mobilerun searches for accommodation.
Find trending content
Shows browsing, app navigation, and result extraction from a natural-language task.
π‘ Example Use Cases
Related MCP Servers
Reviews
No reviews yet β be the first to share how this listing worked for you.
Frequently Asked Questions about Mobilerun
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/mobilerun)HTML Embed
<a href="https://allmcps.com/mcp/mobilerun"><img src="https://allmcps.com/api/badge/mobilerun?style=directory" alt="Mobilerun on AllMCPs" /></a>Technical Specs & Signals
CategoryDeveloper Tools
27Quality signal: Emerging Β· 27/100How this signal is calculated βΎ
Server availabilityNot measured
Not scored for repo-hosted servers β we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership8/20
Documentation & tools11/30
Adoption & activity1/15
Community engagement0/10
A guidance signal from public completeness & health data β not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website β proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it β no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.