Mac Use MCP - install, status & alternatives [2026]

01 · Install Mac Use MCP

Claude Code

claude mcp add antbotlab-mac-use-mcp -- npx -y mac-use-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "antbotlab-mac-use-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mac-use-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package mac-use-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.antbotlab is GitHub-verified and matches the repo owner

03 · What Mac Use MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can capture the screen, a region, or a window by title (PNG or JPEG), get display count, resolution, origin, and scale factor for each display, get current cursor coordinates, and click at screen coordinates with button, click count, and modifier options.

Capability map

Tools grouped from the project's README - what Mac Use MCP lets an agent do.

read & search

4 tools - e.g. Get display count, resolution, origin, and scale factor for each display; Get current cursor coordinates; List all visible windows with positions and sizes

get_screen_info · get_cursor_position · list_windows · get_ui_elements

Click

2 tools - e.g. Click at screen coordinates with button, click count, and modifier options; Click a menu bar item by path (e.g., "File > Save As...")

click · click_menu

Clipboard

2 tools - e.g. Read the current system clipboard as plain text; Write text to the system clipboard

clipboard_read · clipboard_write

Screenshot

1 tool - e.g. Capture the screen, a region, or a window by title (PNG or JPEG)

screenshot

update

1 tool - e.g. Move the cursor to a position

move_mouse

Scroll

1 tool - e.g. Scroll up, down, left, or right at a position

scroll

Drag

1 tool - e.g. Drag from one point to another over a configurable duration

drag

Type

1 tool - e.g. Type text at the cursor position (supports Unicode, CJK, and emoji)

type_text

Limitations (from the README)

[!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.

Latest releases

v1.1.1 · 2026-03-02

Added · mcpName field in package.json for Official MCP Registry publishing · server.json for MCP Registry metadata · smithery.yaml for Smithery directory registration · Add .mcpregistry_ to .gitignore · Backfill…

v1.1.0 · 2026-03-02

What's New · Dramatically improved click accuracy · Agents can now achieve near-pixel-perfect mouse clicks - even on small targets like app icons, toolbar buttons, and mobile screen elements. · Previously, agents had…

v1.0.1 · 2026-03-01

Fixed · Double/triple click recognition via inter-event delay in Swift CGEvent layer (#25) · Negative coordinate support for multi-monitor setups across click, move, scroll, drag, and screenshot schemas (#25)…

04 · Who maintains Mac Use MCP

mac-use-mcp is maintained by antbotlab. It's the only MCP server we track from this author; the repo dates to Feb 2026.

05 · Facts

repository: github.com/antbotlab/mac-use-mcp
category: automation - ranked #151 of 194 actively-maintained automation servers as of 2026-08-25.
registry: io.github.antbotlab/mac-use-mcp (active, first published 2026-03-02)
packages: npm:mac-use-mcp

06 · Mac Use MCP FAQ

Is Mac Use MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-05-01. We re-verify nightly.

What can Mac Use MCP do?

With this server connected, an agent can capture the screen, a region, or a window by title (PNG or JPEG), get display count, resolution, origin, and scale factor for each display, get current cursor coordinates, and click at screen coordinates with button, click count, and modifier options.

How do I install Mac Use MCP?

Run `npx -y mac-use-mcp`. You can also paste the ready-made client config above.

Does Mac Use MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Mac Use MCP

Alternatives to Mac Use MCP

Maintained automation servers if Mac Use MCP isn't the fit.

More automation MCP servers · SYNAPSE CHANNEL · Arr · Claude KVM · Codex Control Plane MCP · Cogni Repo

More TypeScript MCP servers · Cartograph · Leapfrog · Antics MCP · Rftools · Sitecore Server · see all