MCP Catalogs
Homemcp-remote-macos-use screenshot

mcp-remote-macos-use

by baryhuang·482·Score 48

MCP server enabling AI agents to control remote macOS systems without API keys

developer-toolsproductivityother
55
Forks
1
Open issues
11 mo ago
Last commit
2d ago
Indexed

Overview

This MCP server provides a comprehensive solution for remote macOS control through Claude Desktop, offering full desktop capabilities without requiring additional API keys or software installation. It leverages macOS's built-in Screen Sharing functionality to enable AI agents to interact with remote systems, including mouse movements, keyboard input, application launching, and screen capturing. The server is designed with an open architecture that supports multiple LLM providers and integrates seamlessly with MCP clients.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Automate social media management on Twitter and LinkedIn
you:Create video content using CapCut and other macOS applications
you:Automate recruitment processes by collecting and qualifying candidate information
you:Does this require additional API keys?
you:What macOS versions are supported?

When to choose this

Choose this when you need to control remote macOS systems through AI agents without API costs and prefer using native macOS applications.

When NOT to choose this

Don't choose this if you need authentication beyond Apple's protocol 30 or require a more secure 2048-bit RSA encryption.

Tools this server exposes

8 tools extracted from the README
  • remote_macos_get_screen

    Get a screenshot of the remote macOS desktop

  • remote_macos_send_keys

    Send keyboard input to a remote macOS machine

  • remote_macos_mouse_move

    Move the mouse cursor to specified coordinates on a remote macOS machine

  • remote_macos_mouse_click

    Perform a mouse click at specified coordinates on a remote macOS machine

  • remote_macos_mouse_double_click

    Perform a mouse double-click at specified coordinates on a remote macOS machine

  • remote_macos_mouse_scroll

    Perform a mouse scroll at specified coordinates on a remote macOS machine

  • remote_macos_open_application

    Open/activate an application on a remote macOS machine

  • remote_macos_mouse_drag_n_drop

    Perform a mouse drag operation from start point to end point on a remote macOS machine

Comparable tools

openai-operatormacrodmacmcpscreenstudio

Installation

Installation

  1. Enable Screen Sharing on your macOS machine: [Apple Support Guide](https://support.apple.com/guide/remote-desktop/set-up-a-computer-running-vnc-software-apdbed09830/mac)
  1. Connect to your remote macOS: [Apple Connection Guide](https://support.apple.com/guide/mac-help/share-the-screen-of-another-mac-mh14066/mac)
  1. Install Docker Desktop for local Mac: [Docker Installation Guide](https://docs.docker.com/desktop/setup/install/mac-install/)
  1. Add this MCP server to Claude Desktop configuration:
{
  "mcpServers": {
    "remote-macos-use": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "MACOS_USERNAME=your_macos_username",
        "-e",
        "MACOS_PASSWORD=your_macos_password",
        "-e",
        "MACOS_HOST=your_macos_hostname_or_ip",
        "--rm",
        "buryhuang/mcp-remote-macos-use:latest"
      ]
    }
  }
}

FAQ

Does this require additional API keys?
No, this MCP server works with your existing Claude Pro plan and doesn't require additional API keys.
What macOS versions are supported?
It works with all current and future macOS versions, providing universal compatibility.

Compare mcp-remote-macos-use with

GitHub →

Last updated · Auto-generated from public README + GitHub signals.