macos mcp server for Claude Desktop
io.github.cyanheads/macos-mcp-server
Control macOS settings, apps, windows, audio, Music, displays, screenshots, and Focus mode via MCP.
client:Claude Desktop
transport:stdio
runtime:npm
Install macos mcp server in Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json · windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"macos-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/macos-mcp-server"
],
"env": {
"MACOS_SCREENSHOT_DIR": "<MACOS_SCREENSHOT_DIR>",
"MACOS_DISPLAY_LAYOUTS": "<MACOS_DISPLAY_LAYOUTS>",
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
}
}
}
}Settings → Developer → Edit Config opens this file. Restart the app after saving. Claude Desktop docs