# Cyanheads Macos MCP server

Source: https://glimind.com/server/mcp-registry%2Fio.github.cyanheads%2Fmacos-mcp-server
Registry id: `mcp-registry/io.github.cyanheads/macos-mcp-server`
Status: unknown

## Install

```json
{
  "mcpServers": {
    "cyanheads-macos-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/macos-mcp-server"
      ]
    }
  }
}
```

Claude Code:

```sh
claude mcp add cyanheads-macos-mcp-server -- npx -y @cyanheads/macos-mcp-server
```

## Tools (14)

- `macos_check_permissions`: Reports Accessibility, Screen Recording, and Automation permission status for calling process.
- `macos_control_appearance`: Get or set dark/light mode.
- `macos_control_audio`: List audio devices, get defaults, or switch default input/output device.
- `macos_control_music`: Play, pause, stop, skip, play playlist, set shuffle/repeat, or read Music playback.
- `macos_control_system`: Lock the screen or put the display to sleep.
- `macos_control_volume`: Get or set system output volume (0–100) and mute state.
- `macos_get_info`: System snapshot: battery, power, Wi-Fi, hostname, version, uptime, display count.
- `macos_manage_apps`: List running apps, get frontmost app, launch, quit, force-quit, hide, or show apps.
- `macos_manage_displays`: List connected displays and layout names, or apply a named layout preset.
- `macos_manage_finder`: Frontmost path, selection, reveal, open with app, or move to Trash.
- `macos_manage_focus`: Get or set Do Not Disturb / Focus mode.
- `macos_manage_windows`: List, focus, move, resize, minimize, fullscreen, or close windows across visible apps.
- `macos_send_notification`: Post a notification to macOS Notification Center.
- `macos_take_screenshot`: Capture main display, a display, app window, or pixel region as PNG.

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
