hammerspoon-mcp

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.vukvukovich/hammerspoon-mcp",
  "description": "Control macOS through Hammerspoon: windows, apps, and API search. Injection-safe by design.",
  "repository": {
    "url": "https://github.com/vukvukovich/hammerspoon-mcp",
    "source": "github"
  },
  "version": "0.4.0",
  "packages": [
    {
      "registryType": "npm",
      "identifier": "@vukvukovich/hammerspoon-mcp",
      "version": "0.4.0",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "description": "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.",
          "default": "safe",
          "name": "HS_MCP_TOOLS"
        },
        {
          "description": "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.",
          "default": "socket",
          "name": "HS_MCP_TRANSPORT"
        },
        {
          "description": "Explicit path to the Hammerspoon hs command line tool. Only needed when Hammerspoon is installed somewhere unusual.",
          "name": "HS_MCP_HS_PATH"
        },
        {
          "description": "Explicit path to Hammerspoon's bundled docs.json, used by hs_api_search.",
          "name": "HS_MCP_DOCS_PATH"
        },
        {
          "description": "Log verbosity on stderr: debug, info (default), warn, or error.",
          "default": "info",
          "name": "HS_MCP_LOG_LEVEL"
        }
      ]
    }
  ]
}