MacOS-MCP

MacOS-MCP is a lightweight, open-source MCP server that bridges AI agents with the macOS operating system. It enables LLM agents to perform real-world tasks such as app launching, window management, UI interaction, browser automation, desktop state capture, and shell execution using native macOS accessibility and automation APIs.

KEY FEATURES

• Native macOS Integration: Interact with applications, windows, and UI elements through the macOS Accessibility API and Quartz event system.
• Bring Your Own LLM/VLM: Works with any language model and optionally provides visual snapshots when needed.
• Rich Toolset for Desktop Automation: Pre-built tools for application control, mouse and keyboard input, scrolling, shell commands, and desktop state capture.
• Lightweight and Open Source: Minimal setup with a focused Python package and MIT license.

MINIMUM REQUIREMENTS

• Python 3.11 or higher
• macOS 12 or higher
• Accessibility permissions granted to the terminal or application running the MCP server
• UV Package Manager

This MCP server uses UV for running the package in a managed Python environment. Installation: `curl -LsSf https://astral.sh/uv/install.sh | sh` For detailed installation instructions, see the UV documentation