Repository navigation
Releases: Parassharmaa/mac-cua
Release list
v0.1.1 — setup window + cursor fix + 14 tools
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
v0.1.0 — initial release
First public release.
Native macOS Computer Use MCP server. Drives Mac apps in the
background — no focus steal, no cursor motion, no z-order change,
no Space follow.
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
Verified
20/22 in-process eval cases pass; 0 fail; ~10 ms/call under 100×
clickElement stress bench. Closed-loop verifications: Calculator
display readback, TextEdit AXValue readback, Chrome document.title
readback. Full focus-stack: AX enablement re-assert, AXFocused/AXMain
write+restore, NSWorkspace observer with 3s post-action window.
Cursor
Custom violet 4-point pointer with Bezier arc + spring overshoot,
heading rotates body around tip, expanding click ring + bloom halo
on each pulse, 2s idle auto-fade.
Install
Download the zip, copy CuaMcp.app to /Applications, grant
Accessibility + Screen Recording in System Settings → Privacy &
Security on first launch.
MCP client registration:
claude mcp add --scope user mac-cua -- /Applications/CuaMcp.app/Contents/MacOS/cua-mcp