MCP Tools DirectoryAbout this integration
Control macOS through Hammerspoon: windows, apps, and API search. Injection-safe by design.
- Transport
- stdio
- Authentication
- unknown
- Initial setup
- user-authorization
- Runtime
- unattended
- Evidence
- documented
- Version
- 0.4.0
- Package
- @vukvukovich/hammerspoon-mcp
- Last compatibility test
- Not independently tested
Connect your agent
@vukvukovich/hammerspoon-mcpPublisher documentation and package metadata were reviewed without installing the package or connecting to Hammerspoon. The opt-in all-tools tier is not approved for unattended use, and host policy remains authoritative.
Capabilities: inspect and arrange Hammerspoon windows, inspect running applications and screens, search local Hammerspoon API documentation, read the Hammerspoon console and reload configuration
Connected profiles
Additional details
io.github.vukvukovich/hammerspoon-mcp
Source ↗ · Checked 2026-09-170.4.0
Source ↗ · Checked 2026-09-17CC0-1.0; package licenses are separate
Source ↗ · Checked 2026-09-17npm
Source ↗ · Checked 2026-09-17@vukvukovich/hammerspoon-mcp
Source ↗ · Checked 2026-09-200.4.0
Source ↗ · Checked 2026-09-20Eligibility is limited to the default safe tier. Arbitrary Lua, AppleScript, and UI pressing require an explicit wider-tier opt-in and are excluded from the unattended capability set.
Source ↗ · Checked 2026-09-20The server runs as the local user and inherits Hammerspoon's macOS TCC grants. This operating-system permission model is not represented by the native API authentication taxonomy and requires user-authorized local setup.
Source ↗ · Checked 2026-09-20The MCP client spawns the local npm executable and communicates with it over stdio; the server then uses a local Hammerspoon socket or argv-based hs process.
Source ↗ · Checked 2026-09-20Publisher documentation reviewed; package and integration endpoint not executed or independently security-audited.
Source ↗ · Checked 2026-09-20