Skip to content

Releases: Parassharmaa/mac-cua

v0.1.1 — setup window + cursor fix + 14 tools

Choose a tag to compare

@Parassharmaa Parassharmaa released this 25 Apr 01:46

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 than type_text for 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

Choose a tag to compare

@Parassharmaa Parassharmaa released this 25 Apr 01:07

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