MCP Marketplace
Sign inSign up
Back to Browse

Hammerspoon MCP Server

by Vukvukovich
Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

3 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

What You'll Need

Set these up before or after installing:

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.Optional

Environment variable: HS_MCP_TOOLS

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.Optional

Environment variable: HS_MCP_TRANSPORT

Explicit path to the Hammerspoon hs command line tool. Only needed when Hammerspoon is installed somewhere unusual.Optional

Environment variable: HS_MCP_HS_PATH

Explicit path to Hammerspoon's bundled docs.json, used by hs_api_search.Optional

Environment variable: HS_MCP_DOCS_PATH

Log verbosity on stderr: debug, info (default), warn, or error.Optional

Environment variable: HS_MCP_LOG_LEVEL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-vukvukovich-hammerspoon-mcp": {
      "env": {
        "HS_MCP_TOOLS": "your-hs-mcp-tools-here",
        "HS_MCP_HS_PATH": "your-hs-mcp-hs-path-here",
        "HS_MCP_DOCS_PATH": "your-hs-mcp-docs-path-here",
        "HS_MCP_LOG_LEVEL": "your-hs-mcp-log-level-here",
        "HS_MCP_TRANSPORT": "your-hs-mcp-transport-here"
      },
      "args": [
        "-y",
        "@vukvukovich/hammerspoon-mcp"
      ],
      "command": "npx"
    }
  }
}

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

80.0K
Stars
14
Installs
6.5
Security
No ratings yet
Local

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

80.0K
Stars
15
Installs
5.3
Security
No ratings yet
Local

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

180
Stars
690
Installs
8.0
Security
4.8
Local

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

-
Stars
112
Installs
10.0
Security
4.7
Local

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.

-
Stars
84
Installs
10.0
Security
5.0
Remote

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

168.6K
Stars
81
Installs
4.2
Security
5.0
Local