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](https://docs.astral.sh/uv/)