Mac Use MCP server
io.github.antbotlab/mac-use-mcp·v1.1.1·6 starsZero-dependency macOS desktop automation for AI agents. 18 tools via MCP. macOS 13+.
6 stars150 downloads/wk
Reviews
Write oneNobody has reviewed Mac Use yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Mac Use tools (17, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
check_permissionsCheck whether macOS Accessibility and Screen Recording permissions are granted. Returns status for each permission and instructions for any that are missing.
clickClick at the specified screen coordinates. Supports left/right/middle button, single/double/triple click, and modifier keys. …
click_menuClick a menu bar item in an application. Specify the menu path as "Menu > Submenu > Item" (e.g., "File > Save As...", "View > Sort By > Name").
clipboard_readRead the current contents of the macOS clipboard as plain text.
clipboard_writewrite actionWrite text to the macOS clipboard.
focus_windowActivate an application and optionally raise a specific window by title. App name supports fuzzy matching.
get_cursor_positionGet the current mouse cursor position in screen coordinates.
get_screen_infoRetrieve display configuration: number of displays, per-display resolution, origin, and scale factor.
get_ui_elementsQuery visible UI elements of an application via macOS Accessibility API.
list_windowsList visible windows with their app name, title, ID, position, size, and minimized state. Optionally filter by application name. App name supports fuzzy matching (case-insensitive, partial names like 'chrome' for 'Google Chrome').
move_mouseMove the mouse cursor to the specified screen coordinates without clicking. …
open_applicationLaunch an application by name or bundle identifier. App name supports fuzzy matching (e.g. 'chrome' → 'Google Chrome').
press_keySimulate a key press with optional modifiers. Accepts a key combo string like "cmd+c", "ctrl+shift+F5", or "Return". Modifiers: cmd, ctrl, shift, opt/alt.
screenshotCapture a screenshot of the macOS screen. Supports full screen, a rectangular region, or a specific window by title. Returns a base64-encoded image with dimension metadata. Do not narrate visual observations or coordinate calculations. Brief task progress updates are acceptable.
scrollScroll at the specified screen coordinates in the given direction. …
type_textType text at the current cursor position using clipboard paste. Supports full Unicode including CJK characters and emoji. Temporarily replaces clipboard contents. Non-text clipboard content (images, files) will be lost permanently. If secure input is active (e.g. password fields), returns a note suggesting clipboard_write + press_key("cmd+v") as an alternative.
waitPause execution for a specified duration. Useful for waiting between UI operations.
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan20 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 150 days ago8/15
- Maintainer identityregistry namespace matches repository owner6/10
How Mac Use compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 57% of 48,255 servers
- Tools
- 17
- the typical server has 7
- Tools that change things
- 6%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 6
- more than 85% of 28,688 servers
- Downloads a week
- 150
- more than 71% of 12,191 servers with a package
What its tools let an agent do: 14 read · 1 create · 2 change
Install Mac Use in Claude Code, Cursor or VS Code
Runs npx -y mac-use-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mac-use-mcp -- npx -y mac-use-mcp
What the publisher says
From the Mac Use repository's README, as published. We do not edit it. Read it on GitHub
mac-use-mcp
[!WARNING]
This tool has full control over mouse, keyboard, and screen. Please use in a sandboxed environment to protect your privacy and avoid accidental data loss by your agents. You are responsible for any actions performed through this tool.
Zero-native-dependency macOS desktop automation via MCP.
Give AI agents eyes and hands on macOS — click, type, screenshot, and inspect any application.
Use Cases
- Automated UI testing — click buttons, verify element states with getuielements, validate screen content via screenshot
- Desktop workflow automation — launch apps with openapplication, fill forms with typetext, navigate menus via click_menu
- Screenshot-based monitoring — capture screen regions periodically with screenshot for visual diffing or alerting
- Accessibility inspection — query UI element trees with getuielements for QA and compliance checks
- AI agent computer use — give LLMs eyes and hands on macOS via screenshot, click, type_text, and more
Why mac-use-mcp?
- Just works — npx mac-use-mcp and grant two macOS permissions. No node-gyp, no Xcode tools, no build step.
- 18 tools, one server — screenshots, clicks, keystrokes, window management, accessibility inspection, and clipboard.
- macOS 13+ on Intel and Apple Silicon — no native addons, no architecture headaches.
Install
Requirements: macOS 13+ and Node.js 22+. The server communicates over stdio transport.
This package only works on macOS. It will refuse to install on other operating systems.
No build steps. No native dependencies. Just run:
npx mac-use-mcpnpx will prompt to install the package on first run. Use npx -y mac-use-mcp to skip the confirmation.
[!TIP]
Model selection matters. Desktop automation involves screenshot–action loops that add up in token usage. A fast model with solid reasoning, good vision, and reliable tool calling is recommended:
| Model | Provider |
|-------|----------|
| Gemini 3 Flash | Google |
| Claude Sonnet 4.6 | Anthropic |
| GPT-5 mini | OpenAI |
| MiniMax-M2.5 | MiniMax |
| Kimi K2.5 | Moonshot AI |
| Qwen3.5 | Alibaba |
| GLM-4.7 | Zhipu AI |
Permission Setup
mac-use-mcp requires two macOS permissions to function. Grant them once and you're set.
Accessibility
Required for mouse and keyboard control.
- Open System Settings > Privacy & Security > Accessibility
- Click the + button
- Add your MCP client application (e.g., Claude Desktop, your terminal emulator)
- Ensure the toggle is enabled
Screen Recording
Required for screenshots.
- Open System Settings > Privacy & Security > Screen Recording
- Click the + button
- Add your MCP client application
- Ensure the toggle is enabled
- Restart the application if prompted
Verify permissions
After granting both permissions and configuring your MCP client (see next section), use the check_permissions tool to confirm everything is working:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Mac Use: common questions
- Is Mac Use MCP server safe?
- Mostly: it is graded B (78/100). Read the Mac Use safety report
- How do I install Mac Use?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Mac Use need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Mac Use maintained?
- The last commit was 187 days ago (2026-05-01). The latest release is v1.1.1.
- How does Mac Use compare with other MCP servers?
- safety score 78/100 (higher than 57% of 48,255 servers); tools 17 (the typical server has 7); tools that change things 6% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.