# phones

> List the iPhones paired with this Mac, whether each is ready to drive, and who holds it.

Source: https://zeptap.com/docs/cli/commands/phones



## Usage [#usage]

```sh
zeptap phones
```

`zeptap list` does the same.

## Options [#options]

| Option   | Description                                   |
| -------- | --------------------------------------------- |
| `--json` | Print the phones as `data` in one JSON object |

## Details [#details]

* One line per phone: its id, name, model, iOS version, whether it's the active phone, Bluetooth and USB status, whether it's ready (and why not), and its lease if one is held.
* Pass an id or a name to other commands with `-p`, or set `ZEPTAP_PHONE`. Without either, commands act on the only paired phone, or the one active in Zeptap.
* With no paired iPhone it fails and says so.

## Examples [#examples]

```sh
$ zeptap phones
2 iPhones:
id=A1B2 name="Test iPhone" model="iPhone 15" ios=18.1 active=true bluetooth=connected usb=plugged in ready=yes
id=C3D4 name="Spare" model="iPhone 13" ios=17.6 active=false bluetooth=not connected usb=plugged in ready=no (…)
```

## MCP tool [#mcp-tool]

[`list_phones`](https://zeptap.com/docs/agents/tools#list_phones).
