# Give Claude Code a Real Phone

## Prerequisites[​](#prerequisites "Direct link to 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[​](#1-add-mobile-mcp-to-claude-code "Direct link to 1. Add Mobile MCP to Claude Code")

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

## 2. Verify the connection[​](#2-verify-the-connection "Direct link to 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[​](#3-ask-claude-to-interact-with-your-device "Direct link to 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[​](#4-install-and-test-an-app "Direct link to 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[​](#troubleshooting "Direct link to 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[​](#next-steps "Direct link to Next steps")

[Mobile MCP Tools Reference](https://mobilenext.ai/docs/docs/mobile-mcp/tools-reference.md) | [Mobile Next Cloud](https://mobilenext.ai/docs/docs/cloud/overview.md) (for cloud devices)