mobilerun

MCP.Pizza Chef: droidrun

Type or say a task like turning on dark mode or finding a contact, and this tool taps, swipes, and types on your actual phone screen to get it done. It works with Android out of the box and with iPhone through a separate setup, and it connects to the AI provider account of your choice — OpenAI, Anthropic, Gemini, and others — using your own key. Installing it means running a few commands in a computer's terminal, so it suits people comfortable with basic technical setup rather than a plug-and-play app.

Communication
Other

Use This MCP server To

Turn on dark mode without hunting through settings myself Find a contact and start an email to them Take a screenshot of whatever is on my screen Open an app and check a setting for me Complete a multi-step phone task by describing it once Check which app is currently open on my phone

README

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.

Mobilerun automating a phone with natural language

  • 🤖 Control Android and iOS devices with natural language commands
  • 🔀 Use OpenAI, Anthropic, Gemini, 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.

mobilerun FAQ

Can I use this to turn on dark mode or change a setting without touching my phone?
Yes — you can type a plain-English instruction like "turn on dark mode" and it taps through the settings screens for you.
Can I use this to find a contact and send them a message?
Yes — you can ask it to search your contacts and carry out simple multi-step actions like starting an email or a message.
Do I need to be a developer to set this up?
You need to be comfortable running a few commands in a computer's terminal to install it and connect your phone, so it suits people who don't mind basic technical setup rather than a one-click app.
Does this work on both Android and iPhone?
Yes — Android is controlled directly through a companion app installed on the phone, and iPhone is supported through a separate setup process.
Do I need an account or a key from an AI company to use it?
Yes — you connect it to an account with an AI provider such as OpenAI, Anthropic, or Google, and it uses your own key from that account to power the commands.
Does this live inside an app like Claude Desktop or ChatGPT?
No — it runs on its own from a computer's command line rather than inside a chat app, and it sends the instructions you type or speak to whichever AI provider account you connect.
Can it see what's happening on my screen while it works?
Yes — it can look at screenshots of your phone alongside the on-screen layout, which helps it figure out what to tap even in apps it hasn't seen before.
Is there a way to try this without installing anything on my own computer?
Yes — a hosted cloud version is available if you would rather not install and run the tool yourself.