Computer-Use - Remote MacOS Use

Computer-Use - Remote MacOS Use

Open-source MCP server enabling AI to fully control remote macOS desktops with zero extra software.

415
Stars
49
Forks
2
Releases

Overview

The MCP server in this repository provides a turnkey, open-source solution to remotely control macOS desktops via MCP. It is designed as a direct alternative to proprietary operators, optimized for autonomous AI agents with full desktop capabilities and zero additional software on the target Mac. Deployment is Docker-based; the container can be run with environment variables that supply the target Mac credentials and host, enabling seamless remote access without client-side agents on the Mac itself. The server exposes MCP tools for remote macOS control, including screen capture, keyboard input, mouse movements, clicks, scrolling, launching applications, and drag-and-drop operations. WebRTC support is available through LiveKit, offering low-latency real-time screen sharing, with setup instructions to run a LiveKit server or use LiveKit Cloud and corresponding environment variable configuration. The solution emphasizes a native macOS experience, universal LLM compatibility, and a streamlined bootstrap process that leverages Claude Desktop UI for an intuitive workflow. Limitations include support for Apple Authentication (protocol 30) only. A sample Claude Desktop configuration demonstrates how to integrate the Docker image via Claude, with explicit docker run command parameters and environment variables for authentication and host details.

Details

Owner
baryhuang
Language
Python
License
MIT License
Updated
2025-12-07

Features

No Extra API Costs

Free screen processing with your existing Claude Pro plan (no additional per-use API fees).

Minimal Setup

Just enable Screen Sharing on the target Mac—no additional software needed.

Zero Setup on Target Machines

No background applications or agents required on the macOS target.

Screen Sharing is All You Need

Control any Mac with Screen Sharing enabled; reduces backend complexity.

WebRTC Support via LiveKit

Low-latency real-time screen sharing with LiveKit integration for better performance.

Universal LLM Compatibility

Designed to work with any MCP Client; supports integration with OpenAI, Anthropic, or other providers.

Polished Claude Desktop UI

Leverages Claude Desktop's polished UI for an intuitive user experience.

Audience

AI agentsAutonomous agents requiring remote macOS control with a zero-setup Docker-based MCP server.
Claude Desktop usersConfigure Claude Desktop to control a remote Mac via Docker-based MCP server.
Developers and researchersDevelopers and researchers building MCP integrations and contributing improvements to remote macOS control.
IT adminsSecurely manage remote macOS endpoints with a lightweight, Docker-based MCP server.
Mac hosting providersOffer remote Mac management via MCP to clients.

Tags

Remote macOSDesktop controlMCPClaude DesktopWebRTCLiveKitDockerScreen SharingmacOS