# vukvukovich/hammerspoon-mcp

Source: https://glimind.com/server/glama%2Fvukvukovich%2Fhammerspoon-mcp
Registry id: `glama/vukvukovich/hammerspoon-mcp`
Status: unknown

## Tools (24)

- `hs_api_search`: Search Hammerspoon's bundled API reference and return exact signatures.
- `hs_applescript`: Run AppleScript. Reaches Mail, Notes, Reminders, Finder. Requires HS_MCP_TOOLS=all.
- `hs_audio_devices`: List audio output and input devices, showing the current default.
- `hs_audio_set_device`: Switch the default output or input device, for example to headphones.
- `hs_audio_volume`: Get or set volume and mute on the default device.
- `hs_brightness`: Get or set built-in display brightness.
- `hs_console_tail`: Return the last N lines of the Hammerspoon console.
- `hs_eval`: Evaluate arbitrary Lua. Requires HS_MCP_TOOLS=all.
- `hs_focus_app`: Bring an already-running application to the front.
- `hs_focus_window`: Focus a window by id, or by a substring of its title.
- `hs_goto_space`: Switch desktop by id or by 1-based position.
- `hs_health`: Report bridge status: resolved hs path, whether Hammerspoon answers, its version.
- `hs_launch_app`: Launch an application by name, or focus it if it is already running.
- `hs_list_apps`: List running applications, with bundle id, PID, and window count.
- `hs_list_spaces`: List desktops (Spaces) per screen, with positions and which is current.
- `hs_list_windows`: List windows, with id, title, owning app, screen, and frame.
- `hs_machine_status`: Battery, brightness, wifi, idle time, audio, and host info in one call.
- `hs_media_control`: Play, pause, skip, or go back, via system media keys.
- `hs_move_window`: Move or resize a window by id, in absolute screen pixels.
- `hs_notify`: Show a transient on-screen alert, without stealing focus.
- `hs_reload_config`: Reload ~/.hammerspoon/init.lua.
- `hs_screens`: List screens, with id, name, frame, and which one is primary.
- `hs_ui_press`: Press a UI element found by hs_ui_inspect. Refuses without expectLabel or expectRole.
- `hs_window_layout`: Snap a window to a named preset such as left-half or quarter-top-left.

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