mobile-agent-mcp
Provides tools for testing Android apps on emulators and USB devices, including log collection (logcat), screenshots, flow execution, and ADB reverse for React Native/Expo.
Supports Expo projects with host plumbing (e.g., ADB reverse, opening dev URLs) and device management for Android and iOS.
Provides tools for testing iOS apps on simulators, including log collection (sim logs), screenshots, flow execution, and device booting.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mobile-agent-mcprun smoke-login on iOS with logs and screenshot"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mobile-agent-mcp
MCP + CLI for iOS sims, Android emulators, and USB devices. Maestro runs flows; this handles config, doctor, logs, screenshots, RN diagnosis, and Expo/Android host plumbing.
Quick start
npm install -D mobile-agent-mcp
mobile-agent doctor
mobile-agent run-with-context smoke-login ios --jsonRequires Node 20+, Maestro, Xcode (iOS), adb (Android).
Config
mobile-agent.config.json in repo root. See mobile-agent.config.example.json, examples/expo.config.json, examples/bare-rn.config.json.
Set MOBILE_AGENT_PROJECT_ROOT if MCP starts from the wrong cwd.
MCP tools
Tool | Purpose |
| Preflight checks |
| Flow + logs + screenshot + diagnosis |
| Flow execution |
| PNG + inline image |
| Metro, logcat, sim logs |
| Dev lifecycle |
| Flow authoring |
| RN/Expo plumbing |
Resource: mobile-agent://screenshot/latest
Responses: docs/mcp-response-schema.md. Agent loop: docs/agent-skill.md.
MCP config:
{
"mcpServers": {
"mobile-agent": {
"command": "npx",
"args": ["-y", "mobile-agent-mcp"],
"env": { "MOBILE_AGENT_PROJECT_ROOT": "/absolute/path/to/your/project" }
}
}
}CLI
mobile-agent doctor [--json]
mobile-agent run-with-context <flow> [ios|android] [--json]
mobile-agent run-all [ios|android] [--json]
mobile-agent logs [ios|android] [--json] [--duration-ms 3000]
mobile-agent screenshot [ios|android] [--json]
mobile-agent metro-status | reload-app | boot-simulator [--json]
mobile-agent validate-flow <flow> | write-flow <flow> [--template smoke] [--json]
mobile-agent adb-reverse 8081
mobile-agent open-dev-url [ios|android]Flags: --project-root, --flows-dir, --screenshot-dir.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/anthonysbr/mobile-agent-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server