Skip to main content
Glama

mcp-remote-macos-use

MCP Server - Remote MacOs Use

The first open-source MCP server that enables AI to fully control remote macOS systems.

A direct alternative to OpenAI Operator, optimized specifically for autonomous AI agents with complete desktop capabilities, requiring no additional software installation.

Showcases

  • AI Recruiter: Automated candidate information collection, qualifying applications and sending screening sessions using Mail App
  • AI Marketing Intern: LinkedIn engagement - automated following, liking, and commenting with relevant users
  • AI Marketing Intern: Twitter engagement - automated following, liking, and commenting with relevant users

To-Do List (Prioritized)

  1. Performance Optimization - Match speed of Ubuntu desktop alternatives
  2. Apple Scripts Generation - Reduce execution time while maintaining flexibility
  3. VNC Cursor Visibility - Improve debugging and demo experience

We welcome contributions!

Features

  • No Extra API Costs: Free screen processing with your existing Claude Pro plan
  • Minimal Setup: Just enable Screen Sharing on the target Mac – no additional software needed
  • Universal Compatibility: Works with all macOS versions, current and future

Why We Built This

Native macOS Experience Without Compromise

The macOS native ecosystem remains unmatched in user experience today and will continue to be the gold standard for years to come. This is where human capabilities truly thrive, and now your AI can operate in this environment with the same fluency.

Open Architecture By Design

  • Universal LLM Compatibility: Work with any MCP Client of your choice
  • Model Flexibility: Seamlessly integrate with OpenAI, Anthropic, or any other LLM provider
  • Future-Proof Integration: Designed to evolve with the MCP ecosystem

Effortless Deployment

  • Zero Setup on Target Machines: No background applications or agents needed on macOS
  • Screen Sharing is All You Need: Control any Mac with Screen Sharing enabled
  • Eliminate Backend Complexity: Unlike other solutions that require running Python applications or background services

Streamlined Bootstrap Process

  • Leverage Claude Desktop's Polished UI: No need for developer-style Python interfaces
  • Intuitive User Experience: Interact with your AI-controlled Mac through a familiar, user-friendly interface
  • Instant Productivity: Start working immediately without configuration hassles

Architecture

Installation

{ "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" ] } } }

WebRTC Support via LiveKit

This server now includes WebRTC support through LiveKit integration, enabling:

  • Low-latency real-time screen sharing
  • Improved performance and responsiveness
  • Better network efficiency compared to traditional VNC
  • Automatic quality adaptation based on network conditions

To use WebRTC features, you'll need to:

  1. Set up a LiveKit server or use LiveKit Cloud
  2. Configure the LiveKit environment variables as shown in the configuration example above

Developer Instruction

Clone the repo

# Clone the repository git clone https://github.com/yourusername/mcp-remote-macos-use.git cd mcp-remote-macos-use

Building the Docker Image

# Build the Docker image docker build -t mcp-remote-macos-use .

Cross-Platform Publishing

To publish the Docker image for multiple platforms, you can use the docker buildx command. Follow these steps:

  1. Create a new builder instance (if you haven't already):
    docker buildx create --use
  2. Build and push the image for multiple platforms:
    docker buildx build --platform linux/amd64,linux/arm64 -t buryhuang/mcp-remote-macos-use:latest --push .
  3. Verify the image is available for the specified platforms:
    docker buildx imagetools inspect buryhuang/mcp-remote-macos-use:latest

Usage

The server provides Remote MacOs functionality through MCP tools.

Tools Specifications

The server provides the following tools for remote macOS control:

remote_macos_get_screen

Connect to a remote macOS machine and get a screenshot of the remote desktop. Uses environment variables for connection details.

remote_macos_send_keys

Send keyboard input to a remote macOS machine. Uses environment variables for connection details.

remote_macos_mouse_move

Move the mouse cursor to specified coordinates on a remote macOS machine, with automatic coordinate scaling. Uses environment variables for connection details.

remote_macos_mouse_click

Perform a mouse click at specified coordinates on a remote macOS machine, with automatic coordinate scaling. Uses environment variables for connection details.

remote_macos_mouse_double_click

Perform a mouse double-click at specified coordinates on a remote macOS machine, with automatic coordinate scaling. Uses environment variables for connection details.

remote_macos_mouse_scroll

Perform a mouse scroll at specified coordinates on a remote macOS machine, with automatic coordinate scaling. Uses environment variables for connection details.

remote_macos_open_application

Opens/activates an application and returns its PID for further interactions.

remote_macos_mouse_drag_n_drop

Perform a mouse drag operation from start point and drop to end point on a remote macOS machine, with automatic coordinate scaling.

All tools use the environment variables configured during setup instead of requiring connection parameters.

Limitations

  • Authentication Support:
    • Only Apple Authentication (protocol 30) is supported

Security Note

https://support.apple.com/guide/remote-desktop/encrypt-network-data-apdfe8e386b/mac https://cafbit.com/post/apple_remote_desktop_quirks/

We only support protocol 30, which uses the Diffie-Hellman key agreement protocol with a 512-bit prime. This protocol is used by macOS 11 to macOS 12 when communicating with OS X 10.11 or earlier clients.

Here's the information converted to a markdown table:

macOS version running Remote DesktopmacOS client versionAuthenticationControl and ObserveCopy items or install packageAll other tasksProtocol Version
macOS 13macOS 132048-bit RSA host keys2048-bit RSA host keys2048-bit RSA host keys to authenticate, then 128-bit AES2048-bit RSA host keys36
macOS 13macOS 10.12Secure Remote Password (SRP) protocol for local only. Diffie-Hellman (DH) if bound to LDAP or macOS server is version 10.11 or earlierSRP or DH,128-bit AESSRP or DH to authenticate, then 128-bit AES2048-bit RSA host keys35
macOS 11 to macOS 12macOS 10.12 to macOS 13Secure Remote Password (SRP) protocol for local only, Diffie-Hellman if bound to LDAPSRP or DH 1024-bit, 128-bit AES2048-bit RSA host keys macOS 13 to macOS 10.132048-bit RSA host keys macOS 10.13 or later33
macOS 11 to macOS 12OS X 10.11 or earlierDH 1024-bitDH 1024-bit, 128-bit AESDiffie-Hellman Key agreement protocol with a 512-bit primeDiffie-Hellman Key agreement protocol with a 512-bit prime30

Always use secure, authenticated connections when accessing remote remote MacOs machines. This tool should only be used with servers you trust and have permission to access.

License

See the LICENSE file for details.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

The first open-source MCP server that enables AI to fully control remote macOS systems.

  1. To-Do List (Prioritized)
    1. Features
      1. Why We Built This
        1. Native macOS Experience Without Compromise
        2. Open Architecture By Design
        3. Effortless Deployment
        4. Streamlined Bootstrap Process
      2. Architecture
        1. Installation
          1. WebRTC Support via LiveKit
        2. Developer Instruction
          1. Clone the repo
          2. Building the Docker Image
        3. Cross-Platform Publishing
          1. Usage
            1. Tools Specifications
          2. Limitations
            1. Security Note
              1. License

                Related MCP Servers

                • -
                  security
                  A
                  license
                  -
                  quality
                  An enhanced MCP server that grants AI assistants the ability to execute terminal commands on a user's system with improved security controls, designed for use in controlled environments.
                  Last updated -
                  Python
                  MIT License
                  • Apple
                • -
                  security
                  F
                  license
                  -
                  quality
                  An MCP server that allows AI models to execute system commands on local machines or remote hosts via SSH, supporting persistent sessions and environment variables.
                  Last updated -
                  10
                  1
                  TypeScript
                • -
                  security
                  A
                  license
                  -
                  quality
                  An MCP server that integrates Arduino-based robotics (ESP32 or Arduino Nano) with AI, allowing control of hardware components like LEDs, motors, servos, and sensors through AI assistants.
                  Last updated -
                  31
                  MIT License
                • -
                  security
                  A
                  license
                  -
                  quality
                  An MCP server that bridges AI agents with GUI automation capabilities, allowing them to control mouse, keyboard, windows, and take screenshots to interact with desktop applications.
                  Last updated -
                  Python
                  MIT License
                  • Apple
                  • Linux

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/baryhuang/mcp-remote-macos-use'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server