macos mcp server MCP

v0.1.6

io.github.cyanheads/macos-mcp-server

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

transport:stdio runtime:npm

Target client

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

This listing does not declare its tools. Connect the server and your client will discover them on the handshake.

Secrets and scopes

The registry records which variables this server needs, not what privileges they must carry. Issue each one with the narrowest scope that works.

MACOS_SCREENSHOT_DIR
MACOS_DISPLAY_LAYOUTS
MCP_LOG_LEVEL

Runtime

Transport stdio

Registry npm

Package @cyanheads/macos-mcp-server

Version 0.1.6

Provenance Official registry

Package managers

npx npm pnpm yarn bun Homebrew apt Chocolatey winget conda

npx -y @cyanheads/macos-mcp-server

npm install -g @cyanheads/macos-mcp-server

pnpm dlx @cyanheads/macos-mcp-server

yarn dlx @cyanheads/macos-mcp-server

bunx @cyanheads/macos-mcp-server

Want a slot? Make an offer

Registry record

Repository https://github.com/cyanheads/macos-mcp-server

Synced 15 h ago

JSON API /api/v0/servers/io.github.cyanheads/macos-mcp-server