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
2
Stars
0 open issues
8 Aug 2026
Last commit
1 release in 90 days
MIT
License
TypeScript

What the code does

We read the source, 3 d ago · rules 995398eba69f

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": {
      "command": "npx",
      "args": [
        "-y",
        "hammerspoon-mcp"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.hammerspoon]
command = "npx"
args = ["-y", "hammerspoon-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "hammerspoon": {
      "command": "npx",
      "args": [
        "-y",
        "hammerspoon-mcp"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "hammerspoon": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hammerspoon-mcp"
      ]
    }
  }
}

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

30 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

1 994 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+.

106 installs/wk local only
Webdriverio
by webdriverio

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

8 423 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.

4 690 installs/wk local only
best-cad-mcp
by lokmenower

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

264 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 in the form 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 2 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.