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

Project documentation lists get_app_state for the Mac Cua MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), then check which tools your installed version makes available. Tool availability can depend on configuration and credentials. A server handshake does not verify this tool’s behavior. See the full listing for setup details.

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