PluginBench
MCP Server
Active
MIT

io.github.vukvukovich/hammerspoon-mcp MCP Server

io.github.vukvukovich/hammerspoon-mcp

RepositoryRegistry
How to choose

What this kind of tool is for

  • Chain multi-step workflows across the other tools in this directory.
  • Run a scheduled or triggered job instead of retyping the same request.
  • Have your agent watch a feed, queue, or repo and act on new items.

How to compare servers like this

Trigger model:
Understand what starts the automation — a command, a schedule, or an event — before relying on it.
Blast radius:
Prefer tools that hand you a review point before an irreversible action runs.
Chaining cost:
Each chained step adds a failure point; keep critical paths on the fewest tools.
Maintenance signal:
Automations break quietly; a maintained tool is the difference between repair and rediscovery.

This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.

What is the io.github.vukvukovich/hammerspoon-mcp MCP server?

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

How to install io.github.vukvukovich/hammerspoon-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • 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.

~/Library/Application Support/Claude/claude_desktop_config.json
JSON config
{
  "mcpServers": {
    "hammerspoon-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@vukvukovich/hammerspoon-mcp"
      ],
      "env": {
        "HS_MCP_TOOLS": "<YOUR_HS_MCP_TOOLS>",
        "HS_MCP_TRANSPORT": "<YOUR_HS_MCP_TRANSPORT>",
        "HS_MCP_HS_PATH": "<YOUR_HS_MCP_HS_PATH>",
        "HS_MCP_DOCS_PATH": "<YOUR_HS_MCP_DOCS_PATH>",
        "HS_MCP_LOG_LEVEL": "<YOUR_HS_MCP_LOG_LEVEL>"
      }
    }
  }
}

Related MCP servers

SHShipSaving logo

ShipSaving

Maintained

MCP server for ShipSaving — shipping rates, labels, orders, tracking

0
TypeScript
MIT
View repository →

Send three unrelated real people to a physical address in China and get back what they actually saw.

0
MIT
View repository →

Quote, book, and track LTL, FTL, cargo van, and box-truck freight via the Warp API.

3
TypeScript
MIT
View repository →

244 WhatsApp Business AI tools for messaging, automation, marketing, CRM and Shopify

2
JavaScript
MIT
View repository →
LALastBlueTape logo

LastBlueTape

Maintained

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

0
TypeScript
MIT
View repository →
VUVulnCheck logo

VulnCheck

Active

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

7
Go
MIT
View repository →