{"report":{"v":1,"package":"@cyanheads/macos-mcp-server","version":"0.4.0","ranAt":"2026-11-16T11:51:56.430Z","install":{"ok":true,"integrity":"sha512-uRqZ5RxBhvhhiitjFXPR6fCOaA3dw2G5O6ayjH5+wEDs8lF0PXttc0BotVFGl6IQFCwxkeiNfyIuVrKXaQNZbw==","deps":36,"scripts":[],"bins":["macos-mcp-server"],"license":"Apache-2.0","engines":"node >=24.0.0","repository":"git+https://github.com/cyanheads/macos-mcp-server.git","bin":"macos-mcp-server"},"start":{"ok":true,"ms":369,"serverName":"macos-mcp-server","serverVersion":"0.4.0","protocol":"2025-06-18","stderr":"ersion\":\"0.4.0\",\"pid\":60,\"operation\":\"HandleToolRequest\",\"requestId\":\"LYR3C-6IIGF\",\"tenantId\":\"default\",\"timestamp\":\"2026-11-16T11:52:09.116Z\",\"jsonRpcId\":3,\"toolName\":\"macos_get_info\",\"cmd\":\"/sbin/ifconfig\",\"detail\":\"ENOENT\",\"msg\":\"system info probe failed\"}\n{\"level\":20,\"time\":1794829929129,\"env\":\"development\",\"version\":\"0.4.0\",\"pid\":60,\"operation\":\"HandleToolRequest\",\"requestId\":\"LYR3C-6IIGF\",\"tenantId\":\"default\",\"timestamp\":\"2026-11-16T11:52:09.116Z\",\"jsonRpcId\":3,\"toolName\":\"macos_get_info\",\"cmd\":\"/usr/bin/sw_vers\",\"detail\":\"ENOENT\",\"msg\":\"system info probe failed\"}\n{\"level\":20,\"time\":1794829929129,\"env\":\"development\",\"version\":\"0.4.0\",\"pid\":60,\"operation\":\"HandleToolRequest\",\"requestId\":\"LYR3C-6IIGF\",\"tenantId\":\"default\",\"timestamp\":\"2026-11-16T11:52:09.116Z\",\"jsonRpcId\":3,\"toolName\":\"macos_get_info\",\"cmd\":\"/usr/sbin/system_profiler\",\"detail\":\"ENOENT\",\"msg\":\"system info probe failed\"}\n{\"level\":30,\"time\":1794829929129,\"env\":\"development\",\"version\":\"0.4.0\",\"pid\":60,\"operation\":\"HandleToolRequest\",\"requestId\":\"LYR3C-6IIGF\",\"tenantId\":\"default\",\"timestamp\":\"2026-11-16T11:52:09.116Z\",\"jsonRpcId\":3,\"toolName\":\"macos_get_info\",\"uptime\":1916,\"unavailable\":[\"battery\",\"wifi\",\"macos_version\",\"display_count\"],\"data_version\":null,\"msg\":\"macos_get_info\"}\n{\"level\":30,\"time\":1794829929131,\"env\":\"development\",\"version\":\"0.4.0\",\"pid\":60,\"operation\":\"HandleToolRequest\",\"requestId\":\"LYR3C-6IIGF\",\"timestamp\":\"2026-11-16T11:52:09.116Z\",\"jsonRpcId\":3,\"toolName\":\"macos_get_info\",\"metrics\":{\"durationMs\":13.82,\"isSuccess\":true,\"inputBytes\":2,\"outputBytes\":183},\"msg\":\"Tool execution finished.\"}\n"},"tools":[{"name":"macos_get_info","description":"Returns a snapshot of the current macOS system state: battery level, charging state, and power source (AC/Battery/UPS), Wi-Fi association and network name, hostname, macOS version, uptime in seconds, and connected display count. All fields reflect live system state at the time of the call. A field whose probe fails is null and named in `unavailable`, never filled with a guess. macOS withholds the Wi-Fi network name from an app without Location Services access; a connected Mac then reports `connected: true` with `ssid: null`.","params":[]},{"name":"macos_check_permissions","description":"Reports which macOS permissions this server relies on are granted to the calling process, read from Apple's prompt-free checks: Accessibility (every macos_manage_windows action, list included; macos_manage_apps hide and show, and the window_title frontmost reads; the ⌃⌘Q keystroke macos_control_system lock sends before it falls back to the screen saver), Screen Recording (window screenshots), Automation > Finder (macos_manage_finder frontmost_path, get_selection, and trash), and Automation > Music (macos_control_music). No check sends an Apple event to another app, captures the screen, or can show a permission prompt. Each field is true when granted, false when not, and null when the check cannot tell, with the reason in unknown_reasons: Automation > Finder and Automation > Music read null until macOS has asked for consent and while that app is not running. Notifications is always null, since macOS offers no prompt-free check for it. Call this before operations that need these permissions.","params":[]},{"name":"macos_manage_apps","description":"Manage application lifecycle: list all running user-facing apps, get the frontmost app, launch or activate an app, gracefully quit or force-quit a process, or hide/show an app. Launch activates the app if already running; use hidden=true to start in the background without bringing it forward. Force-quit terminates immediately (SIGKILL) without saving. Hide and show require Accessibility permission.","params":["action","app_name","bundle_id","hidden"]},{"name":"macos_control_volume","description":"Get or set the system output volume level (0–100) and mute state of the default output. The get action returns the current level and mute state; on an output with no software volume control, such as many HDMI or DisplayPort displays, both read null and output_device names the device. The set action requires level (0–100), muted (true/false), or both, and fails with volume_unsupported on an output that has no software control for the requested value. Setting level=0 does not mute — use muted=true for explicit muting.","params":["action","level","muted"]},{"name":"macos_send_notification","description":"Post a notification to macOS Notification Center via osascript. The notification is delivered immediately and follows the calling process's notification settings, and an active Focus such as Do Not Disturb silences it unless that Focus allows the posting app. Title is required; body, subtitle, and sound are optional. Each call creates a new notification (not idempotent).","params":["title","body","subtitle","sound"]},{"name":"macos_control_appearance","description":"Get or set the system appearance (dark mode or light mode). The get action returns the current mode. The set action requires mode=\"dark\", \"light\", or \"toggle\". Setting \"dark\" or \"light\" is idempotent — calling twice produces the same state. \"toggle\" flips the current mode on each call.","params":["action","mode"]},{"name":"macos_control_system","description":"System-level power controls. lock sends the ⌃⌘Q lock shortcut through System Events, which needs Accessibility and Automation > System Events. When either permission is denied, lock starts the screen saver instead, which locks the session only when \"Require password after screen saver begins or display is turned off\" is set to Immediately in System Settings > Lock Screen; the method field reports which one ran. sleep_display turns off all displays immediately. Both are reversed by any input (wake or unlock).","params":["action"]},{"name":"macos_manage_windows","description":"Window operations across all visible apps: list all windows with their bounds and state, focus a window, move or resize a window, minimize/restore, enter or exit fullscreen, or close. Every action, list included, scripts System Events and requires Accessibility. Every action except list targets one window: the one titled window_title, or app_name's frontmost window (window_title takes precedence when both are given). Focus raises the window and brings its app forward, as fullscreen does before it changes a window; no action launches an app.","params":["action","app_name","window_title","x","y","width","height","minimized","fullscreen"]},{"name":"macos_control_audio","description":"Manage audio device routing: list all input and output devices, get the current default input and output devices, or switch the default input or output device. Device names support case-insensitive partial matching — \"MacBook\" matches \"MacBook Pro Microphone\". Volume level control is separate (use macos_control_volume). Requires SwitchAudioSource CLI (brew install switchaudio-osx).","params":["action","device","type"]},{"name":"macos_control_music","description":"Control playback in the Music app and read what it is playing: play, pause, stop, skip to the next or previous track, play a playlist by its exact name, set shuffle or repeat, or get the current state. Every action returns the state Music reports afterward — player state, current track, shuffle, and repeat. play and play_playlist launch Music when it is closed; get_current, pause, and stop leave it closed and report running=false; next, previous, set_shuffle, and set_repeat fail with not_running. track is null when Music has nothing loaded, and also, with track_unavailable saying why, when Music refuses to name a track outside the library (radio or catalog playback on recent macOS). The first call shows macOS's Automation consent dialog for Music; if the call times out while it is open, answer the dialog and retry. macos_check_permissions reports the grant as automation_music. System output level belongs to macos_control_volume.","params":["action","playlist","shuffle","repeat"]},{"name":"macos_manage_displays","description":"List connected displays with their current layout (resolution, position, rotation, scaling) and each display's index, the display_index macos_take_screenshot and macos_manage_windows use, or apply a pre-configured display layout by name. Requires displayplacer CLI (brew install displayplacer). Layouts are pre-configured in the MACOS_DISPLAY_LAYOUTS environment variable as a JSON object mapping names to displayplacer argument strings; action=list returns their names as layouts. Layout application only accepts named presets — raw displayplacer args are never accepted from the user.","params":["action","layout_name"]},{"name":"macos_take_screenshot","description":"Capture a screenshot of the main display (the one with the menu bar), one connected display chosen by display_index, a named app window, or a pixel region. display_index is the 0-based index macos_manage_displays action=list reports for each display. Always saves a full-resolution PNG to disk, by default as a new timestamped file in MACOS_SCREENSHOT_DIR (~/Desktop when unset), and never replaces an existing file unless overwrite is true. With include_data, also returns a JPEG preview (longer side at most 1024 px) as an image content block for visual analysis and as base64 in preview. Window capture requires Screen Recording permission; all other targets do not. When the permission check cannot tell whether Screen Recording is granted, the window capture still runs and notice says why.","params":["target","app_name","display_index","region","path","overwrite","include_data"]},{"name":"macos_manage_finder","description":"Finder integration: get the path of the frontmost Finder window, get the current Finder selection, reveal a file or folder in Finder, open a path with a specific app, or move a path to the Trash (recoverable — goes to Trash, not rm). reveal and open_with need no special permissions; frontmost_path, get_selection, and trash script Finder and require Automation > Finder permission. trash moves files to Trash and never falls back to permanent deletion.","params":["action","path","app_name"]},{"name":"macos_manage_focus","description":"Get or set Do Not Disturb / Focus mode. The get action is best-effort: it reads the Focus state file in ~/Library/DoNotDisturb, which may be unreadable to the server process, and returns status \"unknown\" when that file cannot be read or parsed. The set action runs a shortcut named \"Set Focus\" from the Shortcuts library and passes {\"mode\": <mode>, \"enabled\": <enabled>} to it as JSON input. That shortcut is not built in: create it so it reads this input (e.g. with Get Dictionary from Input) and applies mode and enabled with the Set Focus action. Mode names must exactly match configured Focus names (e.g. \"Do Not Disturb\", \"Work\", \"Personal\").","params":["action","mode","enabled"]}],"toolsHash":"f7fbae91165afdf8033dea09244a4601a2c73c97543c02020da98ea586302334","wrote":[],"callsAt":"2026-11-16T11:52:08.111Z","calls":[{"tool":"macos_get_info","ok":true,"ms":19,"bytes":327}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":14,"wrote":0,"callsTried":1,"callsAnswered":1,"callContacts":[]},"history":[{"package":"@cyanheads/macos-mcp-server","version":"0.4.0","ranAt":"2026-11-16T11:51:56.430Z","outcome":"started","tools":14,"contacts":0,"flags":0,"serious":0,"toolsHash":"f7fbae91165afdf8033dea09244a4601a2c73c97543c02020da98ea586302334"}],"page":"https://bragproof.smaverk.com/r/%40cyanheads/macos-mcp-server"}