Skip to content

physical_device_list

List all physical iOS devices currently connected to your Mac via USB or paired over Wi-Fi. This tool reports each device’s name, model, OS version, UDID, and connection state. Use it to discover device identifiers before installing, launching, or streaming console logs from a physical device.

Parameters

This tool takes no parameters.

Usage Examples

List all connected devices

“Show me all the physical devices connected to my Mac”

{}

Example Output

Connected Physical Devices:

iPhone 15 Pro Max
  UDID:         00008130-001A2B3C4D5E6F78
  Model:        iPhone16,2
  OS Version:   18.2
  Connection:   USB
  State:        Available

iPad Air (5th generation)
  UDID:         00008103-000A1B2C3D4E5F60
  Model:        iPad13,17
  OS Version:   17.5.1
  Connection:   Wi-Fi
  State:        Available

iPhone 14
  UDID:         00008110-001122334455AABB
  Model:        iPhone15,3
  OS Version:   18.0
  Connection:   USB
  State:        Available

Total devices found: 3

When no devices are connected:

Connected Physical Devices:

No physical devices found. Connect a device via USB or ensure Wi-Fi pairing is enabled.

physical_device_install — Install an app onto a connected device using its UDID
physical_device_launch — Launch an installed app on a connected device
physical_device_console — Stream console logs from a connected device
simulator_list — List simulator devices if you need to test without a physical device

Tips