Hammerspoon vs Windows MCP

A side-by-side look at the Hammerspoon and Windows MCP MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.

Hammerspoon logoHammerspoonOS Automation · Local subprocess (stdio)macOS automation via Hammerspoon — 75 tools for windows, Spaces, audio, Bluetooth, and more53GoodAuth: not declaredWindows MCP logoWindows MCPOS Automation · Local subprocess (stdio)An MCP Server for computer-use in Windows OS48FairAuth: no auth required

Verdict: choose Hammerspoon for os automation work as a local process; choose Windows MCP for os automation as a local process. You can also run both side by side in one mcpServers block.

Which MCP server should you choose?

Hammerspoon logoChoose Hammerspoon when

  • You need dedicated capabilities in the OS Automation domain.
  • You prefer a local stdio subprocess transport.
  • You want tools like hs_list_windows, hs_focus_window, hs_move_window.
Explore Hammerspoon

Windows MCP logoChoose Windows MCP when

  • You need dedicated capabilities in the OS Automation domain.
  • You prefer a local stdio subprocess transport.
  • Its auth model fits you: No auth required.
Explore Windows MCP

Feature & specification comparison

Rows where the two servers differ are marked.

SpecHammerspoon logoHammerspoonWindows MCP logoWindows MCP
CategoryOS AutomationOS Automation
Quality signal53/100 · Good48/100 · Fair
Install commandConfirmedConfirmed
TransportLocal subprocess (stdio)Local subprocess (stdio)
AuthNot declaredNo auth required
PricingNot declaredFree
Required env varsNone listedNone listed
Verified ownerCommunity listingCommunity listing
GitHub stars210,147
Directory activity 1 views 0 installs 0 upvotes 6 views 0 installs 0 upvotes
Tools75Not listed

Tools & capabilities

Hammerspoon tools 75

  • hs_list_windowsAll visible windows with app, title, frame, id
  • hs_focus_windowBring window to front by id or title match
  • hs_move_windowMove/resize window by id
  • hs_window_layout16 presets (halves, thirds, quarters, grid, cascade, center…) + custom fractional layouts
  • hs_save_layoutSnapshot all window positions as a named layout
  • hs_restore_layoutRestore a saved layout (matches by app + title)
  • hs_list_layoutsList saved layout names
  • hs_spaces_listAll spaces per screen with active markers
  • hs_spaces_activeCurrently focused space + screen
  • hs_spaces_gotoSwitch by ID or index
  • hs_spaces_move_windowMove window to another space (optionally follow)
  • hs_spaces_addCreate a new space
  • +63 more on the listing page

Windows MCP tools

No tool names declared yet. Check the project README from the listing page.

Ready-to-paste client configs

Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.

Hammerspoon

mcpServers (Claude Desktop / Cursor)
{
  "mcpServers": {
    "hammerspoon": {
      "command": "npx",
      "args": [
        "-y",
        "hammerspoon-mcp"
      ]
    }
  }
}

Windows MCP

mcpServers (Claude Desktop / Cursor)
{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

Frequently asked questions

Hammerspoon is categorized under OS Automation and uses a local stdio subprocess. Windows MCP belongs to OS Automation and uses a local stdio subprocess. Pick Hammerspoon for os automation work and Windows MCP for os automation.

Copy the mcpServers block from the config section on this page into your client's config (for example claude_desktop_config.json or ~/.cursor/mcp.json), then fully restart the client.

Hammerspoon has no declared pricing — check the project's own site. Windows MCP is listed as free. Auth: no auth required. If a server needs environment variables such as API keys, define them under the env key in your client's MCP config.

Yes. MCP clients support multiple servers: add hammerspoon and windows-mcp as separate keys in the same mcpServers object, and your assistant will call tools from either one.

On AllMCPs, Hammerspoon has a quality signal of 53/100 (Good) with 1 views, 0 installs and 2 GitHub stars. Windows MCP has 48/100 (Fair) with 6 views, 0 installs and 10,147 GitHub stars.