mobai-mcp — Claude Code MCP server: mobile device automation
Let an AI agent automate Android and iOS devices, emulators, or simulators. Use it to drive app interactions and run .mob tests.
claude mcp add mobai-mcp -- npx -y mobai-mcpWhat mobai-mcp does
mobai-mcp routes device actions through execute_dsl. The agent sends a JSON script with steps such as tapping, entering text, waiting for a condition, and checking that an element exists. Companion tools find devices, capture screenshots, manage apps, and run .mob test cases.
You need Node.js 18+, the MobAI desktop app running locally, and a connected Android or iOS device, emulator, or simulator. Start the device bridge before interacting; without it, actions cannot run on that device. The mobai://reference/device-automation and mobai://reference/testing resources explain the DSL and test syntax.
What it helps with
- automate taps and text entry on a mobile device
- check that a UI element appears after navigation
- save a screenshot for debugging or reporting
- run a
.mobtest case on a selected device - install or remove an app on a device
Example prompts for the agent
- Find the connected devices and open Settings on the selected iPhone.
- Check that the Wi-Fi switch is visible, then save a screenshot.
- Run the project's
.mobtest on the connected Android device.
How to install mobai-mcp
Platform CLI
claude mcp add mobai-mcp -- npx -y mobai-mcpPlatform CLI
codex mcp add mobai-mcp -- npx -y mobai-mcpConfig file
{
"mcpServers": {
"mobai-mcp": {
"command": "npx",
"args": [
"-y",
"mobai-mcp"
]
}
}
}Config file
{
"servers": {
"mobai-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mobai-mcp"
]
}
}
}Platform CLI
gemini mcp add mobai-mcp npx -y mobai-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 mobai-mcp
How do I install mobai-mcp in Claude Code?
Run claude mcp add mobai-mcp -- npx -y mobai-mcp. The setup also requires Node.js 18+ and the MobAI desktop app running locally.
What does mobai-mcp do?
It lets an agent control Android and iOS devices using JSON DSL scripts. It can also discover devices, capture screenshots, manage apps, and run .mob tests.
What must be running before device automation starts?
Run the MobAI desktop app locally and connect a device. Start its bridge with start_bridge before sending device actions.
