Is io.github.mobabur94/hammerspoon safe to use?

io.github.mobabur94/hammerspoon has no known CVEs as of the latest MCPpedia security scan. Authentication requirements were not detected automatically - check the project's documentation before connecting in a shared environment. Licensed under MIT.

How do I install io.github.mobabur94/hammerspoon?

io.github.mobabur94/hammerspoon supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can io.github.mobabur94/hammerspoon do?

io.github.mobabur94/hammerspoon provides 6 tools: Tools, Examples, Prerequisites, Permissions, Development and 1 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with io.github.mobabur94/hammerspoon?

io.github.mobabur94/hammerspoon is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.

Is io.github.mobabur94/hammerspoon actively maintained?

io.github.mobabur94/hammerspoon is recently maintained - last commit was 79 days ago. It has 2 GitHub stars.

io.github.mobabur94/hammerspoon

hammerspoon-mcp

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

2 3/wk 6 tools GitHub npm

No known CVEs

MIT license

Maintained

Last commit 79d ago

Works with most clients

Transport: stdio, http

6 tools · ~151 tok

Grade A · 0.1% of 200K ctx

MCPpedia last refreshed this data 2d ago

Edit this pageView history

io.github.mobabur94/hammerspoon is an MCP server that macOS automation via Hammerspoon — 75 tools for windows, Spaces, audio, Bluetooth, and more. Its tool list has not been published yet over stdio and http, requires no API key, and scores 82/100 on MCPpedia's security, maintenance and efficiency rubric.

Other

Step 1

Install in your client

Config is the same across clients - only the file and path differ.

Supported in Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "hammerspoon": {
      "args": [
        "hammerspoon-mcp"
      ],
      "command": "npx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-mobabur94-hammerspoon)](https://mcppedia.org/s/io-github-mobabur94-hammerspoon)

Read me

What io.github.mobabur94/hammerspoon does

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

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked - your result helps other developers.

npx -y 'hammerspoon-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories - click any category to see the underlying evidence.

Score breakdown

82/100across 5 weighted dimensions

How we score →

0255075100

−18

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked hammerspoon-mcp against OSV.dev.

Inventory

Tools (6)

Click any tool to inspect its schema.

~151 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience - it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.mobabur94/hammerspoon safe to use?: io.github.mobabur94/hammerspoon has no known CVEs as of the latest MCPpedia security scan. Authentication requirements were not detected automatically - check the project's documentation before connecting in a shared environment. Licensed under MIT.
How do I install io.github.mobabur94/hammerspoon?: io.github.mobabur94/hammerspoon supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.mobabur94/hammerspoon do?: io.github.mobabur94/hammerspoon provides 6 tools: Tools, Examples, Prerequisites, Permissions, Development and 1 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.mobabur94/hammerspoon?: io.github.mobabur94/hammerspoon is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.
Is io.github.mobabur94/hammerspoon actively maintained?: io.github.mobabur94/hammerspoon is recently maintained - last commit was 79 days ago. It has 2 GitHub stars.

Similar servers

Others in other

View all →

io.github.sheawinkler/contextlattice95

Private-by-default, local-first memory/context/task orchestrator for MCP apps and agents.

156 4

Dexsql Release95

SQL for Android APK and DEX files: classes, methods, strings, references and smali.

234 2

Boot UI95

The missing developer UI for Spring Boot and Quarkus!

323 1

Awesome Agent Skills95

A curated list of skills, tools, tutorials, and capabilities for AI coding agents (Claude, Codex, Antigravity, Copilot, VS Code)

6.3k 12

MCP Security Weekly

Get CVE alerts and security updates for io.github.mobabur94/hammerspoon and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Other

Step 1

Install in your client

Config is the same across clients - only the file and path differ.

Supported in Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "hammerspoon": {
      "args": [
        "hammerspoon-mcp"
      ],
      "command": "npx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-mobabur94-hammerspoon)](https://mcppedia.org/s/io-github-mobabur94-hammerspoon)

Read me

What io.github.mobabur94/hammerspoon does

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

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked - your result helps other developers.

npx -y 'hammerspoon-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

README

hammerspoon-mcp

Give AI agents deep control over macOS — windows, audio, Bluetooth, Spaces, Focus mode, and 200+ OS APIs — through one MCP server.

What is this?

An MCP server that bridges AI agents to Hammerspoon — the most powerful macOS automation tool available. Unlike screenshot-and-click tools, this gives agents programmatic OS-level access: manage windows by ID, switch audio devices by name, move apps between Spaces, toggle Focus mode, and subscribe to real-time OS events.

75 tools. 12 subscribable resources. Zero native dependencies.

Quick Start

# 1. Install Hammerspoon (if you haven't)
brew install --cask hammerspoon

# 2. Enable the IPC module (one-time setup)
#    Add this line to ~/.hammerspoon/init.lua:
#    require("hs.ipc")
#    Then reload your Hammerspoon config (Cmd+Alt+Ctrl+R or restart the app)

# 3. (Optional) Install the hs CLI symlink for convenience:
#    Run in Hammerspoon console: hs.ipc.cliInstall()
#    Or manually: ln -sf /Applications/Hammerspoon.app/Contents/Frameworks/hs/hs ~/.local/bin/hs

# 4. Run the MCP server
npx hammerspoon-mcp

Note: The server auto-discovers the hs binary — it checks ~/.local/bin/hs, /usr/local/bin/hs, /opt/homebrew/bin/hs, and the app bundle path. You don't need hs on your PATH if Hammerspoon is installed to /Applications.

Architecture

┌─────────────────────────────────────────────────────────┐
│  MCP Client (Claude, Cursor, MeshClaw, etc.)            │
└──────────────────────────┬──────────────────────────────┘
                           │ stdio (JSON-RPC)
┌──────────────────────────▼──────────────────────────────┐
│  hammerspoon-mcp (Node.js)                              │
│  ├─ tools → execSync("hs -c '...'")  (request/response)│
│  └─ watchers → named pipe reader     (push events)     │
└──────────────────────────┬──────────────────────────────┘
                           │ hs CLI / named pipe
┌──────────────────────────▼──────────────────────────────┐
│  Hammerspoon.app (Lua runtime + ObjC bridge)            │
│  200+ modules: window, screen, spaces, audio, wifi,     │
│  bluetooth, battery, USB, filesystem, accessibility...  │
└──────────────────────────┬──────────────────────────────┘
                           │
              macOS APIs (CoreGraphics, IOKit, etc.)

MCP Client Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "hammerspoon": {
      "command": "npx",
      "args": ["hammerspoon-mcp"]
    }
  }
}

Claude Code

claude mcp add hammerspoon -- npx hammerspoon-mcp

Cursor / VS Code / Copilot

Add to .vscode/mcp.json:

{
  "servers": {
    "hammerspoon": {
      "command": "npx",
      "args": ["hammerspoon-mcp"]
    }
  }
}

Kiro

Add to ~/.aws/amazonq/mcp.json:

{
  "mcpServers": {
    "hammerspoon": {
      "command": "npx",
      "args": ["hammerspoon-mcp"]
    }
  }
}

Tools

🪟 Window Management (7)

Tool	Description
`hs_list_windows`	All visible windows with app, title, frame, id
`hs_focus_window`	Bring window to front by id or title match
`hs_move_window`	Move/resize window by id
`hs_window_layout`	16 presets (halves, thirds, quarters, grid, cascade, center…) + custom fract

... View full README on GitHub

Loading README…

Scored, not listed

Why this score

Five weighted categories - click any category to see the underlying evidence.

Score breakdown

82/100across 5 weighted dimensions

How we score →

0255075100

−18

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked hammerspoon-mcp against OSV.dev.

Inventory

Tools (6)

Click any tool to inspect its schema.

~151 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience - it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.mobabur94/hammerspoon safe to use?: io.github.mobabur94/hammerspoon has no known CVEs as of the latest MCPpedia security scan. Authentication requirements were not detected automatically - check the project's documentation before connecting in a shared environment. Licensed under MIT.
How do I install io.github.mobabur94/hammerspoon?: io.github.mobabur94/hammerspoon supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.mobabur94/hammerspoon do?: io.github.mobabur94/hammerspoon provides 6 tools: Tools, Examples, Prerequisites, Permissions, Development and 1 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.mobabur94/hammerspoon?: io.github.mobabur94/hammerspoon is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.
Is io.github.mobabur94/hammerspoon actively maintained?: io.github.mobabur94/hammerspoon is recently maintained - last commit was 79 days ago. It has 2 GitHub stars.