
macOS-MCP
Gives Claude, GPT, or any MCP client direct control over macOS through the Accessibility API. You get tools for clicking coordinates, typing text, launching apps, managing windows, executing AppleScript, and capturing UI state without needing vision models. Works on macOS 12 and up. The server exposes keyboard shortcuts, mouse operations, scrolling, and can extract interactive elements from the accessibility tree. Runs over stdio for desktop clients or SSE/HTTP for network access. Includes a Pi Agent package that wraps the core tools. Requires Accessibility and Screen Recording permissions. Useful when you want an LLM to drive macOS UI directly instead of building custom automation scripts.
- GitHub stars
- 69
- tools
- 10
- transport
- STDIO
- last updated
- May 22, 2026
Tools
10 toolsPublic tool metadata for what this MCP can expose to an agent.
ClickClick at coordinates with support for left, right, and double-click
Click at coordinates with support for left, right, and double-click
No parameter schema in public metadata yet.
TypeType text at cursor position, optionally clearing existing text
Type text at cursor position, optionally clearing existing text
No parameter schema in public metadata yet.
ScrollScroll vertically or horizontally in focused window or regions
Scroll vertically or horizontally in focused window or regions
No parameter schema in public metadata yet.
MoveMove mouse pointer or drag to coordinates
Move mouse pointer or drag to coordinates
No parameter schema in public metadata yet.
ShortcutPress keyboard shortcuts (Cmd+C, Cmd+Tab, etc.)
Press keyboard shortcuts (Cmd+C, Cmd+Tab, etc.)
No parameter schema in public metadata yet.
AppLaunch applications, manage windows (resize/move), switch between apps. Supports app names and bundle IDs
Launch applications, manage windows (resize/move), switch between apps. Supports app names and bundle IDs
No parameter schema in public metadata yet.
DesktopCreate a new Mission Control Space (virtual desktop) via Accessibility, verifying the space count increased
Create a new Mission Control Space (virtual desktop) via Accessibility, verifying the space count increased
No parameter schema in public metadata yet.
ShellExecute commands or AppleScript. Use `mode='osascript'` for AppleScript
Execute commands or AppleScript. Use `mode='osascript'` for AppleScript
No parameter schema in public metadata yet.
ScrapeExtract and convert webpage content to Markdown format
Extract and convert webpage content to Markdown format
No parameter schema in public metadata yet.
WaitPause execution for a defined duration
Pause execution for a defined duration
No parameter schema in public metadata yet.
Sponsors
Readme
Overview
macOS-MCP is a lightweight, open-source Model Context Protocol server that bridges AI agents and the macOS operating system. It enables seamless automation of macOS through LLMs via tasks such as file navigation, application control, UI interaction, browser automation, and system operations.
Supported Operating Systems
- macOS 12 (Monterey)
- macOS 13 (Ventura)
- macOS 14 (Sonoma)
- macOS 15 (Sequoia)
- macOS 26 (Tahoe)
Key Features
Details
- Repository
- github.com/jeomon/macos-mcp
- Category
- Automation & Workflows
- Package
macos-mcp- Transport
- STDIO
- Registry
- MCP registry, active