Loading
Hammerspoon
io.github.vukvukovichClaim this server
Power your agent
Add this server
The publisher's own command. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
Local command
npx -y @vukvukovich/[email protected]Credentials from the publisher
- 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.
Claude Code has no install link for a local command. Copy the command below and run it in a terminal.
shClaude Code
HS_MCP_TOOLS=<value> HS_MCP_TRANSPORT=<value> HS_MCP_HS_PATH=<value> HS_MCP_DOCS_PATH=<value> HS_MCP_LOG_LEVEL=<value> claude mcp add io.github.vukvukovich-hammerspoon-mcp -- npx -y @vukvukovich/hammerspoon-mcp@0.4.0Run in a terminal.
jsonClaude Desktop
{ "mcpServers": { "io.github.vukvukovich-hammerspoon-mcp": { "command": "npx", "args": [ "-y", "@vukvukovich/[email protected]" ], "env": { "HS_MCP_TOOLS": "<value>", "HS_MCP_TRANSPORT": "<value>", "HS_MCP_HS_PATH": "<value>", "HS_MCP_DOCS_PATH": "<value>", "HS_MCP_LOG_LEVEL": "<value>" } } }}claude_desktop_config.json
Local · npmPublisher installStep-by-step: add this in Claude
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
Host a copy with our keys and logs.
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchServer facts
Local- Transport
- stdio
- Version
Tools
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ