← Index

io.github.vukvukovich/hammerspoon-mcp

io.github.vukvukovich/hammerspoon-mcpv0.1.1Search

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

In-path gate · all MCP tools

Using io.github.vukvukovich/hammerspoon-mcp in Claude, Cursor, Gemini CLI, Cline, or Zed?

MCP tool contracts can change remotely with no version bump. The mcpindex gate pins each contract and HOLDs the call when it drifts-before your agent acts. Zero credentials. This is not the package install for this server itself (use Install this server for that).

Install the mcpindex gate (one command)

Rewrites your MCP host config so each server launches behind the gate. Inspect first: curl -fsSL https://mcpindex.ai/install.sh | less

uv tool install mcpindex-gate && mcpindex-config-wire
Auditable install path →Watch it hold a drift →
Trust verdict · v1 advisory · method
NOT YET SCREENEDno verdict on file

Verdict not yet evaluated for this tool. The semantic screen takes adversarial cases first; coverage rolls out as the corpus expands (15/150 labels to graduation). The deterministic conformance probe is built but has not yet run on the public corpus, so a recorded verdict here is REVIEW or UNVERIFIED, never a clearing ALLOW. Until a verdict is recorded, an agent should treat this tool as not-yet-cleared and fall back to its own checks. Method: the eval, four-state verdict, honest limits.

Own this server? Screen its description →

That verdict was true at screening time (snapshot 2026-08-11).

Contracts can change after screening, with no version bump. The gate pins io.github.vukvukovich/hammerspoon-mcp’s tool contracts on first sight and holds any silent change before your agent acts - the check that keeps being true on Tuesday.

See your first HOLD in 2 minutes →

Related: how to trust an MCP server · screen before install · silent contract drift

Environment variables
HS_MCP_TOOLS

Which tools to expose. "safe" (default) exposes inspection and window management only. "all" additionally exposes hs_eval, which runs arbitrary Lua and can do anything the user can do.

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.

MCP quality score · maturity, not trust · methodology
freshness
25
completeness
10
installability
25
documentation
15
stability
5
Alternatives in Search
YTDL RMCP
ai.dinglebear/rytdl

yt-dlp search, download, metadata, delivery, and Plex workflows over MCP and CLI.

YTDL RMCP
ai.dinglebear/ytdl-rmcp

Rust MCP server and CLI for yt-dlp search, downloads, metadata, transfers, and Plex playlists.

Samong
io.github.waanvar/samong

Search your own Markdown notes, including languages written without spaces between words.