Hammerspoon MCP Server

What the code does

We read the source, 7 h ago · rules 3dff92dd89df

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

    const child = spawn(file, [...args], { stdio: ['ignore', 'pipe', 'pipe'] });

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add hammerspoon-mcp -- npx -y @vukvukovich/hammerspoon-mcp

{
  "mcpServers": {
    "hammerspoon-mcp": {
      "args": [
        "-y",
        "@vukvukovich/hammerspoon-mcp"
      ],
      "command": "npx"
    }
  }
}

[mcp_servers.hammerspoon-mcp]
command = "npx"
args = ["-y", "@vukvukovich/hammerspoon-mcp"]

{
  "mcpServers": {
    "hammerspoon-mcp": {
      "args": [
        "-y",
        "@vukvukovich/hammerspoon-mcp"
      ],
      "command": "npx"
    }
  }
}

{
  "mcpServers": {
    "hammerspoon-mcp": {
      "args": [
        "-y",
        "@vukvukovich/hammerspoon-mcp"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: 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.). The author declared them in the registry entry; get the values from the project itself.