macos mcp server for VS Code

io.github.cyanheads/macos-mcp-server

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

client:VS Code transport:stdio runtime:npm

Install macos mcp server in VS Code

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "macos-screenshot-dir",
      "description": "MACOS_SCREENSHOT_DIR",
      "password": true
    },
    {
      "type": "promptString",
      "id": "macos-display-layouts",
      "description": "MACOS_DISPLAY_LAYOUTS",
      "password": true
    },
    {
      "type": "promptString",
      "id": "mcp-log-level",
      "description": "MCP_LOG_LEVEL",
      "password": true
    }
  ],
  "servers": {
    "macos-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/macos-mcp-server"
      ],
      "env": {
        "MACOS_SCREENSHOT_DIR": "${input:macos-screenshot-dir}",
        "MACOS_DISPLAY_LAYOUTS": "${input:macos-display-layouts}",
        "MCP_LOG_LEVEL": "${input:mcp-log-level}"
      }
    }
  }
}

VS Code prompts for each input the first time the server starts, so no secret is written to the file. VS Code docs

macos mcp server in other clients

macos mcp server MCP server