MacOS-MCP

Manages macOS applications with four modes: 'launch' (opens the application), 'resize' (adjusts active window size), 'move' (repositions active window), 'switch' (brings specific app into focus).

Performs mouse clicks at specified coordinates [x, y]. Supports button types: 'left' for selection/activation, 'right' for context menus, 'middle'. Supports clicks: 0=hover only, 1=single click, 2=double click.

Moves mouse cursor to coordinates [x, y]. Set drag=True to perform a drag-and-drop operation from current position to target coordinates.

Sends a macOS notification banner with a message, title, optional subtitle, and optional sound. Supported sounds: Glass, Ping, Basso, Tink, Funk, Bottle, Frog, Hero, Morse, Pop, Purr, Sosumi, Submarine.

Fetch content from a URL. Performs a lightweight HTTP request and returns the page content as text.

Scrolls at coordinates [x, y] or current mouse position if loc=None. Type: vertical (default) or horizontal. Direction: up/down for vertical, left/right for horizontal. wheel_times controls scroll amount.

Execute commands on macOS. Modes: 'shell' (default) for bash/zsh commands, 'osascript' for AppleScript. Use for file system, process management, system operations, and automation scripts.

Executes keyboard shortcuts using key combinations separated by +. Examples: 'command+c' (copy), 'command+v' (paste), 'command+tab' (switch apps), 'command+space' (Spotlight). Note: Use 'command' instead of 'ctrl' on macOS.

Captures complete desktop state including: focused window, open applications, interactive elements (buttons, text fields, links, menus with coordinates), and scrollable areas. Set use_vision=True to include screenshot with numbered annotations on interactive elements.

Types text at specified coordinates [x, y]. Set clear=True to clear existing text first. Set press_enter=True to submit after typing. Set caret_position to 'start', 'end', or 'idle' (default).