get_app_state

MCP tool from Mac Cua by hyprcat

Capture a window's accessibility tree + screenshot.Called each turn before interaction.

How to use it

get_app_state is exposed by the Mac Cua MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the get_app_state tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.

Install Mac Cua

$claude mcp add mac-cua -- uv run --directory /path/to/mac-cua python main.py

FULL MAC CUA LISTING

Other tools in Mac Cua (8)

click

Click by element index or pixel coordinates. Supports double-click, right-click. All clicks are background-targeted.

drag

Drag between two pixel coordinates

list_apps

List running and recently-used apps with bundle IDs and usage stats

perform_secondary_action

Invoke non-primary AX actions (expand, collapse, zoom, raise)

press_key

Send key combos inxdotool syntax (super+c, Return, Tab) to a specific process

scroll

Scroll a specific element by direction and page count

set_value

Directly set an accessibility element's value— no focus or typing needed

type_text

Type literal text via background keyboard input— keys go to the target process, not your focused app