ui_find_element
Searches the iOS app's accessibility tree for UI elements by label or unique ID, with substring or exact matching.
Instructions
[ios-simulator-mcp] Searches the accessibility tree and returns elements matching the given criteria
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"search": "<search>"
},
"name": "ui_find_element"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Filter by element type (e.g. 'Button', 'StaticText', 'Group'). Case-insensitive exact match | |
| udid | No | Udid of target, can also be set with the IDB_UDID env var | |
| search | Yes | Array of search strings. An element matches if ANY string matches against its AXLabel or AXUniqueId | |
| matchMode | No | Match mode for search strings: 'substring' (default) or 'exact' | substring |
| caseSensitive | No | Whether search matching is case-sensitive (default: false) |