Safari Screenshot

A Node.js MCP Server for capturing screenshots using Safari on macOS.

Features

Capture window screenshots at specific sizes
Support for different zoom levels
Configurable wait times for page load
Clean up after capture
Native macOS screenshot quality

Usage

import { takeScreenshot } from './screenshot.js'; // Basic window screenshot await takeScreenshot({ url: 'https://www.apple.com', outputPath: './screenshot.png', width: 1024, // Optional: window width (default: 1024) height: 768, // Optional: window height (default: 768) waitTime: 3, // Optional: seconds to wait for load (default: 3) zoomLevel: 1, // Optional: page zoom level (default: 1) }); // Responsive design testing await takeScreenshot({ url: 'https://www.apple.com', outputPath: './mobile.png', width: 375, // iPhone SE width height: 667, // iPhone SE height zoomLevel: 1, }); // High-resolution capture await takeScreenshot({ url: 'https://www.apple.com', outputPath: './desktop-hd.png', width: 1920, // Full HD width height: 1080, // Full HD height waitTime: 5, // Wait longer for HD content zoomLevel: 0.8, // Zoom out slightly });

Requirements

macOS
Safari
Node.js >= 14.0.0
Terminal needs Accessibility permissions (System Preferences → Security & Privacy → Privacy → Accessibility)

Installation

npm install safari-screenshot

Options

Option	Type	Default	Description
url	string	required	The URL to capture
outputPath	string	auto	Where to save the screenshot (default: ./screenshots/[hostname]-[timestamp].png)
width	number	1024	Window width in pixels
height	number	768	Window height in pixels
waitTime	number	3	Seconds to wait for page load
zoomLevel	number	1	Page zoom level (1 = 100%)

Common Viewport Sizes

The module is tested with these common viewport sizes:

Desktop: 1920×1080 (Full HD)
Laptop: 1366×768
Tablet Landscape: 1024×768
Tablet Portrait: 768×1024
Mobile Large: 428×926 (iPhone 12 Pro Max)
Mobile Medium: 390×844 (iPhone 12 Pro)
Mobile Small: 375×667 (iPhone SE)

How It Works

Opens Safari with specified window size
Loads the URL and waits for page load
Applies zoom level if specified
Uses native macOS screencapture for pixel-perfect results
Verifies screenshot was captured successfully
Cleans up Safari windows

Permissions

This package requires System Events permissions to work:

Open System Preferences > Security & Privacy > Privacy > Accessibility
Add Terminal (or your IDE) to the list of allowed apps

Using with Cursor

Setup in Cursor

Open Cursor
Go to settings, "Add MCP Server"
In the configuration dialog:
- Name: safari-screenshot
- Type: command
- Command: npx -y @rogerheykoop/mcp-safari-screenshot
Or for local development:
- Command: npx -y /path/to/mcp-safari-screenshot/server.js

Example Commands

After connecting to the server in Cursor, you can use these commands:

Take a screenshot of https://apple.com at desktop size

Response: Will capture at 1920×1080

Capture https://apple.com on iPhone 12 Pro

Response: Will capture at 390×844

Screenshot github.com at 50% zoom

Response: Will capture with zoomLevel: 0.5

Supported Parameters

The MCP server understands these concepts:

Device names (e.g., "iPhone", "iPad", "desktop")
Dimensions (e.g., "1024x768")
Zoom levels (e.g., "50% zoom", "2x zoom")
Wait times (e.g., "wait 5 seconds")

Example Workflows

Responsive Testing
Take screenshots of apple.com on iPhone, iPad, and desktop
Zoom Testing
Capture github.com at 75% zoom and 125% zoom
Custom Size
Screenshot example.com at 1440x900

Tips

Screenshots are saved to the screenshots directory by default
Device names automatically set appropriate dimensions
The server handles cleanup of Safari windows
Use "wait X seconds" for slow-loading pages

Troubleshooting

If you encounter issues:

Check Terminal has Accessibility permissions
Verify Safari is not in private browsing mode
Ensure the working directory is writable
Check Cursor's console for error messages

License

MIT

Testing Locally

You can test the MCP implementation directly:

# Test discovery echo '{"type":"discover"}' | npx -y ./server.js # Test screenshot echo '{"type":"execute","tool":"take_screenshot","input":"Take a screenshot of https://apple.com","requestId":"123"}' | npx -y ./server.js

Expected responses:

Discover will return capabilities
Execute will:
- Log progress to stderr
- Return result JSON to stdout
- Save screenshot to ./screenshots/

Deploy Server

HTTP connection URL

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

take_screenshot

Enables capturing high-quality native macOS screenshots using Safari through a Node.js server, supporting various sizes, zoom levels, and load wait times.

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-screenshot
kazuph
A
security
A
license
A
quality
Provides screenshot and OCR capabilities for macOS.
Last updated -
1
38
22
MIT License
MCP iOS Simulator Screenshot
yorifuji
A
security
A
license
A
quality
A server that captures screenshots from iOS Simulator using the Model Context Protocol (MCP) and saves them to a specified directory.
Last updated -
1
0
1
MIT License
Peekaboo MCP
steipete
A
security
A
license
A
quality
A macOS utility that captures screenshots and analyzes them with AI vision, enabling AI assistants to see and interpret what's on your screen.
Last updated -
3
7,031
638
MIT License
Screeny MCP Server
rohanrav
-
security
A
license
-
quality
A privacy-first macOS MCP server that enables AI agents to capture screenshots of pre-approved application windows for development and debugging tasks.
Last updated -
6
MIT License

View all related MCP servers

Safari Screenshot MCP Server