mcpbeat Sign in

Hammerspoon MCP Server

by mobabur94 Your server? Claim it
local only

Hammerspoon runs on your own machine — the client starts it, so there is no endpoint to ping. 26 installs a week from npm. Last commit 8 Aug 2026.

macOS automation via Hammerspoon — 75 tools for windows, Spaces, audio, Bluetooth, and more

Installs per day peak 123 · avg 4
a month agotoday
26
Installs / week
npm · hammerspoon-mcp
1
Stars
0 open issues
8 Aug 2026
Last commit
0 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 19 h ago · rules 3dff92dd89df

A tool parameter reaches a dangerous call

A value the model can set ends up inside a file or shell call. That is not a flaw by itself — for a terminal server it is the job — but it is where things go wrong when it is not.

A tool parameter reaches a dangerous call hs_audio_mute.device → src/bluetooth-tools.ts:172, hs_finder_selection.path → src/extra-tools.ts:183, hs_bluetooth_connect.device → src/bluetooth-tools.ts:123 и ещё 28
      return bridge.eval(`
Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

      return bridge.eval(`
Runs an external command src/bridge.ts:31, src/watchers.ts:35
      const result = execSync(`${this.hsPath} -c '${escaped}'`, {

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

A tool parameter here reaches a dangerous call

That is not a flaw by itself — but it is where things go wrong when it is not the job. We re-read this code on every release. Watch it and you hear from us the day another one appears.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add hammerspoon -- npx -y hammerspoon-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "hammerspoon": {
      "args": [
        "-y",
        "hammerspoon-mcp"
      ],
      "command": "npx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.hammerspoon]
command = "npx"
args = ["-y", "hammerspoon-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "hammerspoon": {
      "args": [
        "-y",
        "hammerspoon-mcp"
      ],
      "command": "npx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "hammerspoon": {
      "args": [
        "-y",
        "hammerspoon-mcp"
      ],
      "command": "npx"
    }
  }
}

Alternatives to Hammerspoon

same job, measured the same way
MCP Osascript
by m0rvayne

macOS automation: 17 typed tools for windows, menus, keyboard, clipboard, tabs, screenshots

60 installs/wk local only
MCP Sap Gui
by kts982

SAP GUI for Windows automation for AI agents - 59 structured tools via SAP GUI Scripting API

273 installs/wk local only
MCP Server for PowerPoint
by trsdn

PowerPoint automation for AI - Slides, Shapes, Text, Charts and more. Windows only.

local only
Mac Use MCP
by antbotlab

Zero-dependency macOS desktop automation for AI agents. 18 tools via MCP. macOS 13+.

90 installs/wk local only
Webdriverio
by webdriverio

MCP server with WebdriverIO for browser and mobile app automation (iOS/Android via Appium)

5 275 installs/wk local only
Toolpiper
by modelpiper

On-device MCP tools for macOS: local AI, speech, vision, browser automation, system control.

local only
MCP Server for Excel
by sbroenne

Excel automation for AI - Sheets, Power Query, DAX, VBA, Tables, Ranges and more. Windows only.

local only
best-cad-mcp
by lokmenower

Windows AutoCAD MCP server for handle-first CAD automation, validation, and drawing exports.

288 installs/wk local only

Hammerspoon — questions

Answers built from our own checks of this server.

Why is there no uptime for Hammerspoon?
Hammerspoon runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package hammerspoon-mcp was installed 26 times last week.
How do I connect Hammerspoon?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls hammerspoon-mcp straight from npm; nothing to host, nothing to sign up for.
How many people use Hammerspoon?
The npm package hammerspoon-mcp was installed 26 times in the last week. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Hammerspoon open source?
Yes — it is published under the MIT licence, written in TypeScript and 1 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.