find
Search for UI elements by name to locate buttons, text fields, or links for automation. Returns element IDs for clicking, typing, or reading across desktop applications.
Instructions
Search for UI elements by name.
Finds elements matching a text query, ranked by match quality.
Returns element IDs that you can use with click, set_value, etc.
Use the FULL visible text for best results (e.g. "Send Message"
not just "Send").
Args:
query: Text to search for (e.g. "Send Message", "Submit", "Search").
app: Scope to this application (e.g. "Firefox", "Slack").
window_id: Scope to this window.
role: Only match this role (e.g. "button", "text_field", "link").
states: Only match elements with ALL these states (e.g. ["enabled", "visible"]).
max_results: Maximum matches to return.
fields: Which fields to search -- ["name"], ["name", "value"], or ["name", "value", "description"].
source: "full" (default, merged native+web), "ax" (CDP accessibility tree only), "native" (platform only), or "dom" (live DOM).Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| app | No | ||
| window_id | No | ||
| role | No | ||
| states | No | ||
| max_results | No | ||
| fields | No | ||
| source | No | full |