macos-mcp-server

Indexed by io.github.cyanheads

About

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

Use this server

Add it to your MCP client. The catalogue lists this config verbatim from its source — it does not run, download, or vouch for the server. Review the command before you run it.

Transportstdio (runs a local command)

Env varsMACOS_SCREENSHOT_DIR MACOS_DISPLAY_LAYOUTS MCP_LOG_LEVEL

Claude Code

claude mcp add --env MACOS_SCREENSHOT_DIR= --env MACOS_DISPLAY_LAYOUTS= --env MCP_LOG_LEVEL= macos-mcp-server -- npx @cyanheads/macos-mcp-server

Cursor

Add to Cursor

If the button doesn't open Cursor, use the JSON below — Cursor accepts the same mcpServers config.

VS Code

code --add-mcp '{"name":"macos-mcp-server","command":"npx","args":["@cyanheads/macos-mcp-server"],"env":{"MACOS_SCREENSHOT_DIR":"","MACOS_DISPLAY_LAYOUTS":"","MCP_LOG_LEVEL":""}}'

JSON

{
  "mcpServers": {
    "macos-mcp-server": {
      "command": "npx",
      "args": [
        "@cyanheads/macos-mcp-server"
      ],
      "env": {
        "MACOS_SCREENSHOT_DIR": "",
        "MACOS_DISPLAY_LAYOUTS": "",
        "MCP_LOG_LEVEL": ""
      }
    }
  }
}

Environment variables are listed by name only — fill in your own values. Entries never carry secrets.