Skip to main content

Give Claude Code a Real Phone

Prerequisites​

A booted iOS simulator or Android emulator (or connected real device). Node.js v22+.

  • iOS: xcrun simctl boot "iPhone 16" to start a simulator
  • Android: start an emulator via Android Studio or emulator -avd <name>

1. Add Mobile MCP to Claude Code​

claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest

2. Verify the connection​

In Claude Code, type /mcp. You should see mobile-mcp listed and connected.

3. Ask Claude to interact with your device​

Some example prompts:

  • "List the devices available and take a screenshot of the current screen"
  • "Open the Settings app and navigate to Wi-Fi settings"
  • "Launch com.example.myapp, sign in with email user@example.com and password test123"
  • "Take a screenshot, describe what's on screen, then tap the first button you see"

4. Install and test an app​

Install the app at /path/to/MyApp.ipa, launch it, and tell me what you see on the home screen.

Troubleshooting​

  • If no devices appear: confirm your simulator/emulator is booted (xcrun simctl list or adb devices)
  • If Mobile MCP disconnects: restart Claude Code and reconnect via /mcp

Next steps​

Mobile MCP Tools Reference | Mobile Next Cloud (for cloud devices)

Last updated on