Hammerspoon-mcp Server

Hammerspoon-mcp is an MCP integration. Control macOS through Hammerspoon: windows, apps, and API search. Injection-safe by design.

Packages and local setup

The published npm package is @vukvukovich/hammerspoon-mcp, version 0.4.0. Its declared MCP transport is stdio.

The package declares HS_MCP_TOOLS: Which tools to expose. "safe" (default) exposes inspection, window management, and system tools only. "all" additionally exposes hs_eval, hs_applescript, and hs_ui_press, which run arbitrary Lua and AppleScript and press UI elements - anything the user can do.; HS_MCP_TRANSPORT: How Lua reaches Hammerspoon. "socket" (default) keeps one persistent Unix domain socket, self-installed on first call, with automatic fallback to spawning; "spawn" runs one hs process per call.; HS_MCP_HS_PATH: Explicit path to the Hammerspoon hs command line tool. Only needed when Hammerspoon is installed somewhere unusual.; HS_MCP_DOCS_PATH: Explicit path to Hammerspoon's bundled docs.json, used by hs_api_search.; HS_MCP_LOG_LEVEL: Log verbosity on stderr: debug, info (default), warn, or error..

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 0.4.0 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related developer tools MCP servers for tools that cover the same kind of work.