Remote macOS Use

What it does

Connects AI agents to macOS systems via VNC and Screen Sharing, enabling the LLM to interact with the desktop, move the mouse, send keystrokes, and manage applications autonomously.

Tools

• remote_macos_get_screen: Captures a screenshot of the remote desktop.
• remote_macos_send_keys: Sends keyboard input to the remote Mac.
• remote_macos_mouse_move: Moves the cursor to specific coordinates.
• remote_macos_mouse_click: Performs a mouse click at coordinates.
• remote_macos_mouse_double_click: Performs a double-click at coordinates.
• remote_macos_mouse_scroll: Scrolls at specific coordinates.
• remote_macos_open_application: Opens or activates a specific application.
• remote_macos_mouse_drag_n_drop: Drags an item from one point to another.

Installation

Enable Screen Sharing on the target Mac. Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "remote-macos-use": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e", "MACOS_USERNAME=your_username",
        "-e", "MACOS_PASSWORD=your_password",
        "-e", "MACOS_HOST=your_host_or_ip",
        "--rm",
        "buryhuang/mcp-remote-macos-use:latest"
      ]
    }
  }
}

Supported hosts

• Claude Desktop