io.github.vukvukovich/hammerspoon-mcp

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

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "hammerspoon-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@vukvukovich/hammerspoon-mcp@0.4.0"
      ],
      "env": {
        "HS_MCP_TOOLS": "safe",
        "HS_MCP_TRANSPORT": "socket",
        "HS_MCP_LOG_LEVEL": "info"
      }
    }
  }
}

Environment variables

HS_MCP_TOOLSWhich 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_TRANSPORTHow 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_LOG_LEVELLog verbosity on stderr: debug, info (default), warn, or error.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category: Developer Tools
Version: 0.4.0
Registry: active
Published: 8/14/2026

Browse all Developer Tools →

Mantis

vulinh1704

Real-browser UI checks and speed audits for coding agents, catching fixes that only hide the bug.

Developer ToolsAdded 1 week ago

Spend Guard

vulinh1704

Budgets, payee allowlists, price-spike checks and human approval for agents paying x402 paywalls

Developer ToolsAdded 1 week ago

VULK

VULK-dev

Create and continue apps and websites with your own VULK plan and credits.

Developer ToolsAdded 1 month ago

LastBlueTape

vulkanr

Construction punch list management for AI agents. Create lists, add items, track progress.

Developer ToolsAdded 8 months ago

VulnCheck

vulncheck-oss

VulnCheck exploit intelligence — CVE research, exploit data, advisories, and threat analysis.

Developer ToolsAdded 4 weeks ago

Vi Assistant by Vultax

Vultax

Vi market evidence, hypothetical price scenarios and published Vultax research.

Developer ToolsAdded 1 month ago

Add the badge to your site

Show visitors that io.github.vukvukovich/hammerspoon-mcp is listed here — it’s also the link we check for a free listing.

HTML — for your website

<a href="https://serverdex.io/server/io-github-vukvukovich-hammerspoon-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="io.github.vukvukovich/hammerspoon-mcp — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![io.github.vukvukovich/hammerspoon-mcp — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-vukvukovich-hammerspoon-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.