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/)