Repository navigation
Highlights
- Floating setup window on every launch — menubar fallback for
machines where the status item gets clipped behind the display
notch or hidden by Bartender-style menubar managers. Permission
rows refresh live (1 s poll); no relaunch required. - Two new tools (14 total):
paste— NSPasteboard + cmd+v. Faster thantype_textfor long
or unicode-heavy content; restores prior clipboard.wait_for_element— poll AX tree until predicate matches.
Returns the element index with the cache already refreshed.
- Cursor rendering fix — overlay panel bumped 56→80 with scale
recomputed; body wings no longer clip the layer. - Stale-TCC detection — verifies AX functionally via a Finder
AXRole probe and surfaces a "restart this app" hint when macOS
reports granted but the underlying SPI rejects calls. - Better menubar icon — template SF symbol that respects
light/dark menubars; small colored corner badge when permissions
are missing (no more solid-red triangle).
Tools (14)
list_apps, get_app_state (capture_mode som/ax/vision), click,
press_key, type_text, set_value, scroll, drag,
perform_secondary_action, paste, wait_for_element, get_clipboard,
set_clipboard, get_permissions
Install
Download zip, copy CuaMcp.app to /Applications, grant Accessibility
-
Screen Recording in System Settings on first launch.
claude mcp add --scope user mac-cua -- /Applications/CuaMcp.app/Contents/MacOS/cua-mcp