About io.github.cyanheads/macos-mcp-server
io.github.cyanheads/macos-mcp-server is an MCP server in the Browser category: control macOS system settings, apps, windows, audio, displays, screenshots, and Focus mode via MCP.
Install
claude mcp add io-github-cyanheads-macos-mcp-server -- npx -y @cyanheads/macos-mcp-servernpx -y @cyanheads/macos-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (13)
macos_check_permissionsReports Accessibility, Screen Recording, Automation > Finder, and Notification status for the calling process
Parameters not published.
macos_control_appearanceGet or set dark/light mode
Parameters not published.
macos_control_audioList audio devices, get current defaults, or switch the default input/output device
Parameters not published.
macos_control_systemLock the screen or put the display to sleep
Parameters not published.
macos_control_volumeGet or set system output volume (0–100) and mute state
Parameters not published.
macos_get_infoSystem snapshot: battery level and charging status, power source, Wi-Fi SSID, hostname, macOS version, uptime, and display count
Parameters not published.
macos_manage_appsList, launch, quit, force-quit, hide, or show applications
Parameters not published.
macos_manage_displaysList connected displays and apply named display layout presets
Parameters not published.
macos_manage_finderFrontmost path, current selection, reveal, open with app, or move to Trash
Parameters not published.
macos_manage_focusGet or set Do Not Disturb / Focus mode
Parameters not published.
Show all 13 tools
macos_manage_windowsList, focus, move, resize, move_resize, minimize, fullscreen, or close windows
Parameters not published.
macos_send_notificationPost a notification to macOS Notification Center
Parameters not published.
macos_take_screenshotCapture full screen, display, named app window, or pixel region; saves PNG; optional base64 JPEG preview
Parameters not published.
Ask AI
Ask AI about io.github.cyanheads/macos-mcp-server
Powered by Claude · Grounded in docs
Security checks
6 checks have not been run yet.