mobilerun — Claude Code MCP server for Android and iOS control
Lets an agent drive a real Android or iOS device: tap, swipe, type, and carry out multi-step flows described in plain words.
claude mcp add --transport http mobilerun https://api.mobilerun.ai/v1/mcpWhat mobilerun does
mobilerun is an open-source framework that hands LLM agents mobile-native tools. The agent inspects the UI tree, reads screenshots, taps, swipes, types, and plans longer sequences. You drive it from the CLI or the Python API.
Android devices connect through the Portal app and adb; iPhones go through mobilerun-ios over USB, and the iOS Simulator through the iOS Portal app. Pick from OpenAI, Anthropic, Gemini, xAI, Ollama, DeepSeek, OpenRouter or any OpenAI-compatible endpoint. Anthropic support ships as an optional extra at install time.
Python >=3.11,<3.14 is required — 3.14 is not supported yet. On Android you need ADB installed plus Developer options and USB debugging switched on. Provider keys come from environment variables or the mobilerun configure wizard.
What it helps with
- walk through a settings flow on a physical phone
- check which app is in the foreground from a screenshot
- find a contact and send that person an email
- record a macro and replay it later
- debug a long automation run with execution tracing
Example prompts for the agent
- Open the settings app and switch on dark mode
- Tell me what app is currently open, use --vision
How to install mobilerun
Platform CLI: remote server
claude mcp add --transport http mobilerun https://api.mobilerun.ai/v1/mcpPlatform CLI: remote server
codex mcp add mobilerun --url https://api.mobilerun.ai/v1/mcpConfig file
{
"mcpServers": {
"mobilerun": {
"url": "https://api.mobilerun.ai/v1/mcp"
}
}
}Config file
{
"servers": {
"mobilerun": {
"type": "http",
"url": "https://api.mobilerun.ai/v1/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http mobilerun https://api.mobilerun.ai/v1/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mobilerun
How do I install mobilerun in Claude Code?
Run claude mcp add --transport http mobilerun https://api.mobilerun.ai/v1/mcp.
What does mobilerun do?
It gives an LLM agent control over a phone screen: taps, swipes, typing, UI-tree and screenshot reading. Tasks are described in natural language and run from the CLI or Python API.
What do I need before the first run?
Python >=3.11,<3.14; on Android, ADB with USB debugging enabled; on iPhone, mobilerun-ios. Set the provider key through an environment variable or mobilerun configure.
