mcp-mobile

Automate mobile device interaction and testing workflows using MCP tool commands.

1|Updated Sep 12, 2025
One-click install
npx skills add https://github.com/JimmyTranDev/dotfiles --skill mcp-mobile
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-mobile
Source: https://github.com/JimmyTranDev/dotfiles/tree/main/src/opencode/skills/mcp-mobile
Command: npx skills add https://github.com/JimmyTranDev/dotfiles --skill mcp-mobile

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables automated interaction and testing of mobile apps across iOS simulators and Android emulators, reducing manual QA overhead.

Core Features & Use Cases

  • Discover devices and their states, launch apps by package name, and inspect on-screen element trees with coordinates.
  • Perform taps, swipes, typing, and orientation changes to drive UI flows, capture screenshots, and validate UI behavior.
  • Use cases include end-to-end UI testing, device onboarding, and reproducible bug reproduction in mobile environments.

Quick Start

Launch a device, pick an app, and start interacting with on-screen elements.

Frequently Asked Questions about mcp-mobile

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate mobile app testing on iOS simulators and Android emulators?

Automate mobile app testing by using deterministic MCP tool commands to drive device interaction workflows. You can discover devices, launch apps by package name, and run UI flows including taps, swipes, typing, and orientation changes across iOS and Android environments.

How does element discovery work for mobile UI testing automation?

Element discovery for mobile UI testing works by inspecting on-screen element trees and extracting coordinates. The mobile_list_elements_on_screen command queries the active screen layout, enabling automated taps and swipes on specific UI components.

Can I capture screenshots and record interactions during automated mobile testing?

Yes, you can capture screenshots and validate UI behavior during automated mobile testing. The mobile_take_screenshot command records the current screen state, which is essential for reproducible bug reproduction and end-to-end UI testing validation.

What do I need to set up before running automated swipe and tap workflows on mobile devices?

Before running automated swipe and tap workflows, you need available iOS simulators or Android emulators and the target app's package name. The mobile_list_available_devices command verifies connected device states and readiness before app launch and interaction.

Is there a way to programmatically change screen orientation during mobile emulator testing?

Yes, programmatic orientation changes are supported during mobile emulator testing. The mobile_set_orientation command alters the device screen layout, allowing you to validate responsive UI behavior and reproduce orientation-specific bugs within automated testing workflows.

What are the limitations of using MCP patterns for mobile device interaction?

MCP patterns for mobile device interaction apply deterministic command sets suited for reproducible UI tasks. They are limited to iOS simulators and Android emulators, meaning physical hardware device testing and real sensor interaction workflows are outside the supported scope.