MCP server
Hammerspoon
macOS automation via Hammerspoon — 75 tools for windows, Spaces, audio, Bluetooth, and…
Runs locallyStatus and history
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- 6 days ago
About Hammerspoon
Hammerspoon is an open-source MCP server. It runs locally on your machine and is started by your AI client.
macOS automation via Hammerspoon — 75 tools for windows, Spaces, audio, Bluetooth, and more
Install
Run in a terminal
claude mcp add hammerspoon -- npx -y hammerspoon-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"hammerspoon": {
"command": "npx",
"args": [
"-y",
"hammerspoon-mcp"
]
}
}
}Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"hammerspoon": {
"command": "npx",
"args": [
"-y",
"hammerspoon-mcp"
]
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"hammerspoon": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hammerspoon-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"hammerspoon": {
"command": "npx",
"args": [
"-y",
"hammerspoon-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"hammerspoon": {
"command": "npx",
"args": [
"-y",
"hammerspoon-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Pricing
Open source
Hammerspoon FAQ
Is Hammerspoon free?
Yes. Hammerspoon is open source, so you can use and self-host it for free.
How do I add Hammerspoon to Claude Code?
Run this command in your terminal: claude mcp add hammerspoon -- npx -y hammerspoon-mcp
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.