Mac Use

Local Mac desktop control for Grok and Cursor via a bundled stdio MCP server.

HID input matches Dottie: CGEvent posted on .cghidEventTap. Coordinates are screen points (main display, origin top-left). Screenshots are resized to that size, so image pixels and clicks share one space.

What it is

Prefer the smallest surface that fits.

Related MCP server: macinput

Install

Grok

grok plugin install /path/to/mac-use --trust

Or add the folder under ~/.grok/plugins/ (auto-trusted) and enable it.

Cursor

mkdir -p ~/.cursor/plugins/local
ln -s /path/to/mac-use ~/.cursor/plugins/local/mac-use
cd ~/.cursor/plugins/local/mac-use && npm install

Then Developer: Reload Window. Call mac_use_status.

First input/screenshot compiles server/helper.swift with swiftc (Xcode or CLT).

macOS permissions

Grant Accessibility and Screen Recording to:

1. mac-use-helper (built next to the Swift source)

2. The host that launched the MCP server (Grok, Cursor, or Terminal)

mac_use_status requests the TCC prompt and opens the matching Settings pane when a grant is missing. After you flip the toggle, quit and reopen Grok.

Tools

Always screenshot after acting. Confirm before destructive actions. Do not paste secrets from chat into type_text.

Agent loop

1. mac_use_status

2. screenshot (or get_screen_size)

3. One action in those points

4. Screenshot again

Dev

cd ~/Desktop/projects/mac-use
npm install
npm run build-helper
npm test
npm start   # stdio MCP

• Entry: server/index.js

• Driver: server/driver-impl.js → server/helper.swift

• Cursor: .cursor-plugin/plugin.json + mcp.json

• Grok: plugin.json + .mcp.json

• Skill: skills/mac-use/SKILL.md

License

MIT / Steve Derico