macos mcp server for Claude Code

io.github.cyanheads/macos-mcp-server

Control macOS system settings, apps, windows, audio, displays, screenshots, and Focus mode via MCP.

client:Claude Code transport:stdio runtime:npm

Install macos mcp server in Claude Code

run in your project directory

claude mcp add macos-mcp-server -e MACOS_SCREENSHOT_DIR=<MACOS_SCREENSHOT_DIR> -e MACOS_DISPLAY_LAYOUTS=<MACOS_DISPLAY_LAYOUTS> -e MCP_LOG_LEVEL=<MCP_LOG_LEVEL> -- npx -y @cyanheads/macos-mcp-server

Adds it for this project only. Append --scope user to make it available everywhere. Claude Code docs

macos mcp server in other clients

Claude Desktop
Cursor
VS Code
Zed
Windsurf
Cline
Gemini CLI
Grok
LangChain

macos mcp server MCP server