MCP.Market

Mac Use MCP server

by antbotlab·io.github.antbotlab/mac-use-mcp·v1.1.1·6 stars

Zero-dependency macOS desktop automation for AI agents. 18 tools via MCP. macOS 13+.

B78/100grade B
What users say
No reviews yet
Be the first
Safety scan
B78/100

full report

Adoption
Growing

6 stars150 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • check_permissions

    Check whether macOS Accessibility and Screen Recording permissions are granted. Returns status for each permission and instructions for any that are missing.

  • click

    Click at the specified screen coordinates. Supports left/right/middle button, single/double/triple click, and modifier keys. …

  • click_menu

    Click 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_read

    Read the current contents of the macOS clipboard as plain text.

  • clipboard_writewrite action

    Write text to the macOS clipboard.

  • focus_window

    Activate an application and optionally raise a specific window by title. App name supports fuzzy matching.

  • get_cursor_position

    Get the current mouse cursor position in screen coordinates.

  • get_screen_info

    Retrieve display configuration: number of displays, per-display resolution, origin, and scale factor.

  • get_ui_elements

    Query visible UI elements of an application via macOS Accessibility API.

  • list_windows

    List 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_mouse

    Move the mouse cursor to the specified screen coordinates without clicking. …

  • open_application

    Launch an application by name or bundle identifier. App name supports fuzzy matching (e.g. 'chrome' → 'Google Chrome').

  • press_key

    Simulate 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.

  • screenshot

    Capture 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.

  • scroll

    Scroll at the specified screen coordinates in the given direction. …

  • type_text

    Type 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.

  • wait

    Pause 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

no findings
  • 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
Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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-mcp

npx 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.

  1. Open System Settings > Privacy & Security > Accessibility
  2. Click the + button
  3. Add your MCP client application (e.g., Claude Desktop, your terminal emulator)
  4. Ensure the toggle is enabled

Screen Recording

Required for screenshots.

  1. Open System Settings > Privacy & Security > Screen Recording
  2. Click the + button
  3. Add your MCP client application
  4. Ensure the toggle is enabled
  5. 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.