Skip to content
VS Code

hammerspoon mcp for VS Code

io.github.vukvukovich/hammerspoon-mcp

Control macOS through Hammerspoon: windows, apps, and API search. Injection-safe by design.

client:VS Code transport:stdio runtime:npm

Install hammerspoon mcp in VS Code

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "hs-mcp-tools",
      "description": "HS_MCP_TOOLS",
      "password": true
    },
    {
      "type": "promptString",
      "id": "hs-mcp-transport",
      "description": "HS_MCP_TRANSPORT",
      "password": true
    },
    {
      "type": "promptString",
      "id": "hs-mcp-hs-path",
      "description": "HS_MCP_HS_PATH",
      "password": true
    },
    {
      "type": "promptString",
      "id": "hs-mcp-docs-path",
      "description": "HS_MCP_DOCS_PATH",
      "password": true
    },
    {
      "type": "promptString",
      "id": "hs-mcp-log-level",
      "description": "HS_MCP_LOG_LEVEL",
      "password": true
    }
  ],
  "servers": {
    "hammerspoon-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@vukvukovich/hammerspoon-mcp"
      ],
      "env": {
        "HS_MCP_TOOLS": "${input:hs-mcp-tools}",
        "HS_MCP_TRANSPORT": "${input:hs-mcp-transport}",
        "HS_MCP_HS_PATH": "${input:hs-mcp-hs-path}",
        "HS_MCP_DOCS_PATH": "${input:hs-mcp-docs-path}",
        "HS_MCP_LOG_LEVEL": "${input:hs-mcp-log-level}"
      }
    }
  }
}

VS Code prompts for each input the first time the server starts, so no secret is written to the file. VS Code docs

hammerspoon mcp in other clients