Safari Screenshot

Provides an MCP server to automate Safari-based screenshots on macOS across multiple sizes and zoom levels.

typescript

1

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "rogerheykoop-mcp-safari-screenshot": {
      "command": "npx",
      "args": [
        "-y",
        "@rogerheykoop/mcp-safari-screenshot"
      ]
    }
  }
}

You can automate high-quality Safari screenshots on macOS with this MCP server. It launches Safari at a chosen window size, waits for pages to load, optionally adjusts zoom, captures the screen using native macOS tools, and cleans up afterward for reliable results across desktop and mobile-like viewports.

How to use

Connect to the Safari screenshot MCP server from your MCP client and issue commands that describe the page you want to capture. You can specify the target URL, the desired viewport size, a wait time for slow pages, and a zoom level. The server will launch Safari, apply the requested settings, take a pixel-perfect screenshot, and store the image in the default screenshots folder or a location you specify.

How to install

Prerequisites: you need macOS, Safari, and Node.js version 14 or newer. Ensure Terminal (or your development environment) has Accessibility permissions so the automation can control Safari.

Install the MCP server package locally or globally.

npm install safari-screenshot

Run the MCP server that exposes the Safari screenshot functionality.

npx -y @rogerheykoop/mcp-safari-screenshot

When prompted or configured in your MCP client, connect using the provided MCP command to register this server under a concise name like safari_screenshot.

Configuration and notes

You can configure the MCP connection to expose the server as a stdio endpoint that runs locally with a standard command. The suggested configuration is shown here for reference:

{
  "mcpServers": {
    "safari_screenshot": {
      "command": "npx",
      "args": ["-y", "@rogerheykoop/mcp-safari-screenshot"]
    }
  }
}

Troubleshooting and tips

Make sure Terminal has Accessibility permissions in System Preferences under Security & Privacy. If Safari is in private browsing mode, disable it for reliable automation. Ensure your working directory is writable so screenshots can be saved to disk. If you run into issues, check the MCP client’s console for error messages and verify that the server is properly registered and reachable.

Available tools

take_screenshot

Captures a webpage screenshot using Safari with configurable width, height, waitTime and zoomLevel.