Safari MCP Server

Navigate to a URL in Safari. Waits for page to fully load.

Go back in browser history

Go forward in browser history

Reload the current page

Read page text content (title, URL, body text). Use for reading article text or page content. For interacting with elements, prefer safari_snapshot (gives ref IDs). Use selector to read specific element. Use maxLength to limit output.

Get HTML source of current page

PREFERRED way to see page state. Returns accessibility tree with ref IDs for every interactive element. Use refs with click/fill/type instead of CSS selectors. Workflow: snapshot → see refs → click({ref:'0_5'}). PREFER THIS over safari_screenshot (cheaper, structured text vs heavy image) and over safari_read_page (includes interactive refs). Use safari_screenshot only when you need to see visual layout/styling.

Navigate to a URL and return the page content in one step — saves 1 full round-trip vs navigate+read_page. Use instead of safari_navigate + safari_read_page.

Click element. Use ref (from snapshot), selector, text, or x/y. Works on React/Airtable/virtual DOM apps via full PointerEvent+MouseEvent sequence + React Fiber fallback. Pure JS — never touches user's mouse. When using ref, always take a FRESH safari_snapshot first — refs expire after each new snapshot.

Click an element then return the updated page — saves 1 full round-trip vs separate click+read_page. Handles both React Router navigation and full page loads.

Double-click an element by CSS selector or x/y coordinates (e.g. to select a word in text)

Right-click (context menu) an element by CSS selector or x/y coordinates

OS-level mouse click via macOS CGEvent — produces isTrusted: true events that pass WAF/bot detection (G2, Cloudflare, etc.). Use when regular safari_click fails with 405/403 errors or form submissions are blocked. Trade-off: physically moves the mouse cursor and requires Safari window to be visible. Use ref (from snapshot), selector, text, or x/y. When using ref, always take a FRESH safari_snapshot first.

Fill/replace value in an input, textarea, select, OR contenteditable (rich text). Handles React controlled inputs, ProseMirror, Draft.js, and Google Closure editors automatically. Use for SETTING a value (replaces existing). For code editors (Monaco/CodeMirror/Ace), use safari_replace_editor instead. For character-by-character typing in search boxes, use safari_type_text. IMPORTANT: When using ref, always take a FRESH safari_snapshot first — refs expire after each new snapshot (prefix changes: 5_xx → 6_xx).

Clear an input field

Select an option in a native dropdown. Sets .value and dispatches change event. For custom dropdowns (React/LinkedIn), use safari_click on the dropdown trigger, then safari_click on the option instead.

Fill multiple form fields at once

Press a keyboard key (enter, tab, escape, arrows, etc). Supports modifiers (cmd, shift, alt, ctrl).

Type text character-by-character with realistic key events. Best for: search boxes (triggers autocomplete), chat inputs, and fields that react to each keystroke. For rich text editors (Medium, HackerNoon, LinkedIn), use safari_fill instead — it uses framework-native APIs. For code editors (Monaco/CodeMirror), use safari_replace_editor. When using ref, always take a FRESH safari_snapshot first — refs expire after each new snapshot.

Replace ALL content in a code editor (Monaco, CodeMirror, Ace, ProseMirror). Use ONLY for code editors — Airtable automations, GitHub gists, CodePen, n8n code nodes, etc. NOT for rich text editors like Medium/LinkedIn (use safari_fill for those). Detects ProseMirror/Draft.js/CodeMirror/Monaco/Ace and uses their native API.

Take a visual screenshot (base64 JPEG). EXPENSIVE — use safari_snapshot instead for most tasks. Only use screenshot when you need to verify visual layout, styling, images, or colors that snapshot can't show.

Take a screenshot of a specific element (by CSS selector). Returns base64 PNG image.

Scroll the page up or down by a specified amount

Scroll to a specific position on the page

List all open tabs in Safari with their titles and URLs

Open a new tab, optionally with a URL

Close the current tab

Switch to a specific tab by index (use safari_list_tabs to see indices). All subsequent commands (click, fill, evaluate, screenshot, scroll) will target this tab. If commands seem to run on the wrong tab, call switch_tab again to re-anchor.

Wait for an element or text to appear on the page

Wait for a new tab to appear (e.g. after OAuth login click opens popup). Automatically switches to the new tab.

Execute JavaScript in the current page. Automatically falls back to AppleScript when CSP blocks execution (e.g. Google Search Console, LinkedIn). For reading data, prefer safari_read_page or safari_snapshot. For interactions, prefer safari_click/fill with refs.

Get detailed info about an element (tag, text, rect, attributes, visibility)

Find all elements matching a CSS selector (returns tag, text, href, value)

Hover over element. Use ref, selector, or x/y

Set up handler for the next alert/confirm/prompt dialog

Resize the Safari window

Drag an element to another element or position. Use CSS selectors or x/y coordinates.

Upload a file to a element via JavaScript DataTransfer — NO file dialog, NO UI interaction. IMPORTANT: Do NOT click the file input before calling this tool — just provide the selector and file path. If a file dialog is already open, this tool will close it first. NOTE: 'verified 0 files' may appear even on success if the site uses a custom upload handler — check visually with safari_snapshot.

Paste an image from a local file into the focused element via JS DataTransfer (no clipboard, no focus steal). Works on Medium, dev.to, HackerNoon, TOI, etc.

Emulate a mobile device by resizing window and setting user agent. Devices: iphone-14, iphone-14-pro-max, ipad, ipad-pro, pixel-7, galaxy-s24. Or use custom width/height.

Reset device emulation back to desktop mode

Get cookies for the current page

Get localStorage data for the current page

Quick network overview via Performance API (no setup needed). Shows URLs and timing for resources loaded by the page. For detailed request/response info (headers, status codes, POST bodies), use safari_start_network_capture + safari_network_details instead.

Batch multiple Safari actions in ONE call. Steps: [{action, args}]. Actions match other safari_* tool names without prefix (e.g. 'navigate', 'click', 'fill', 'evaluate', 'readPage').

Start capturing console messages (log, warn, error, info). Call once per page.

Get captured console messages (must call safari_start_console first)

Clear all captured console messages

Save the current page as a PDF file. Uses screencapture + PDF rendering (no Safari UI interaction needed).

Get the accessibility tree of the page (roles, ARIA labels, focusable elements, form states). Essential for a11y auditing.

Set a cookie on the current page

Delete a specific cookie or all cookies for the current page

Get sessionStorage data for the current page

Set a value in sessionStorage

Set a value in localStorage

Delete a localStorage key, or clear all localStorage (omit key to clear all)

Delete a sessionStorage key, or clear all sessionStorage (omit key to clear all)

Export all storage state (cookies + localStorage + sessionStorage) as JSON — useful for saving and restoring login sessions

Import storage state from JSON (as exported by safari_export_storage) — restores cookies, localStorage, sessionStorage

Read the current clipboard content (text)

Write text to the system clipboard

Intercept network requests matching a URL pattern and return a mock response. Works with both fetch and XHR. Useful for testing API error states, offline behavior, or replacing API responses.

Remove all network route mocks (restore real network behavior)

Wait for a fixed time in milliseconds. Use only when you need a brief pause between actions. PREFER safari_wait_for (waits for element/text to appear) — it's smarter and doesn't waste time.

Start capturing detailed network requests (fetch + XHR) with headers, status, timing. Call once per page. Intercepts fetch/XHR — captures requests AFTER this call only. For quick overview of already-loaded resources, use safari_network instead.

Get captured network requests with full details (must call safari_start_network_capture first)

Clear all captured network requests

Get detailed performance metrics: navigation timing, Web Vitals (FCP, LCP, CLS), resource breakdown, memory usage

Simulate slow network conditions. Profiles: slow-3g, fast-3g, 4g, offline. Or custom latency/speed. Call with no args to reset.

Get console messages filtered by level (must call safari_start_console first)

Extract HTML tables as structured JSON (headers + rows). Perfect for scraping data tables.

Extract all meta tags: title, description, canonical, OG tags, Twitter cards, JSON-LD, alternate languages, RSS feeds

Extract all images with src, alt, dimensions, loading strategy, viewport visibility

Extract all links with href, text, rel, target, external/nofollow detection

Override the browser's geolocation API to return custom coordinates

Get computed CSS styles for an element. Optionally filter specific properties.

List all IndexedDB databases on the current page

Read records from an IndexedDB database store

Analyze CSS coverage: find unused CSS rules across all stylesheets. Shows coverage percentage per stylesheet.

Auto-detect all forms on the page with their fields, types, selectors, and submit buttons. Great for automated form filling.

Scroll to element by CSS selector OR text. For virtual DOM (Airtable) use text — scrolls down until text appears in DOM.

Click an element AND wait for the result (page load or element). Use instead of click + wait_for separately.

Fill a form AND submit it in one operation. Finds submit button automatically if not specified.

Full page analysis in ONE call: title, URL, meta tags, OG, headings, link stats, image stats, forms, and text preview. Perfect for SEO/audit.