MCPSafari

v1.0.0Browser Automationstable

MCPSafari: Native Safari MCP Server for AI Agents

accessibilityagentic-aiai-agent-toolsai-agentsai-tools
Share:
24
Stars
0
Downloads
0
Weekly
0/5

What is MCPSafari?

MCPSafari is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcpsafari: native safari mcp server for ai agents

MCPSafari: Native Safari MCP Server for AI Agents

This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCPSafari: Native Safari MCP Server for AI Agents

Use Cases

Native Safari browser control
macOS automation
Web interaction for agents
Epistates

Maintainer

LicenseMIT
Languagejavascript
Versionv1.0.0
UpdatedMay 19, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcpsafari

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCPSafari

MCPSafari is a native macOS MCP server that gives AI agents direct, programmatic control over the Safari browser using Apple's Accessibility APIs — no WebDriver or headless browser required. It exposes 23 tools covering tab management, navigation, page reading, DOM interaction (click, type, scroll, form input, drag), JavaScript execution, screenshot capture, and Safari DevTools access (console logs, network requests). Designed for agentic AI workflows on macOS, it enables Claude and other MCP clients to browse the web, fill forms, extract page content, and automate repetitive browser tasks natively.

Prerequisites

  • macOS 13 (Ventura) or later with Safari installed
  • Apple Silicon or Intel Mac (separate binaries available for each)
  • Accessibility permissions granted to the terminal or MCP client application in System Settings > Privacy & Security > Accessibility
  • An MCP-compatible client such as Claude Desktop or Claude Code CLI
  • Homebrew (optional, for the easiest installation)
1

Install MCPSafari

Install via Homebrew for the simplest setup, or download the pre-built binary manually for Apple Silicon.

# Homebrew (recommended)
brew install --cask epistates/tap/mcp-safari

# Manual (Apple Silicon)
curl -L -o /usr/local/bin/mcp-safari \
  https://github.com/Epistates/MCPSafari/releases/latest/download/MCPSafari-Server-arm64-apple-darwin
chmod +x /usr/local/bin/mcp-safari
2

Grant Accessibility permissions

Open System Settings > Privacy & Security > Accessibility and add your terminal application (Terminal, iTerm2, or the app running Claude Desktop) to the allowed list. This is required for MCPSafari to control Safari.

3

Add to Claude Code CLI (quickest method)

Register the server with Claude Code using the mcp add command.

claude mcp add --scope user mcp-safari mcp-safari
4

Or configure Claude Desktop

Add the server to your Claude Desktop configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json.

5

Verify the server is working

Open Safari, then ask Claude to list open tabs or take a screenshot. The typical workflow is: get context with tabs_context, capture the DOM snapshot, interact using element UIDs, then verify with a screenshot.

MCPSafari Examples

Client configuration

Add MCPSafari to Claude Desktop. No environment variables are required — the server controls Safari via macOS Accessibility APIs.

{
  "mcpServers": {
    "mcp-safari": {
      "command": "mcp-safari"
    }
  }
}

Prompts to try

Use these prompts to control Safari and automate web tasks through Claude.

- "Open a new Safari tab and navigate to https://news.ycombinator.com."
- "Take a screenshot of the current Safari tab."
- "Find the search box on this page and type 'MCP server'."
- "Read the main article text from the current page."
- "Click the first link on the page and tell me where it goes."
- "Show me any JavaScript console errors on this page."

Troubleshooting MCPSafari

MCPSafari cannot control Safari — accessibility errors or permission denied

Open System Settings > Privacy & Security > Accessibility and ensure the application running the MCP server (e.g., Terminal, Claude Desktop) is in the allowed list. Restart the application after granting permissions.

Element interaction fails — click or type commands do nothing

First call the snapshot tool to get current element UIDs, then use those UIDs in subsequent click/type commands. Stale UIDs from a previous snapshot will not work after page navigation or dynamic DOM updates.

Server binary not found after Homebrew install

Run 'brew link epistates/tap/mcp-safari' to ensure the binary is linked to /usr/local/bin. You can also verify the path with 'which mcp-safari' and update your shell PATH if needed.

Frequently Asked Questions about MCPSafari

What is MCPSafari?

MCPSafari is a Model Context Protocol (MCP) server that mcpsafari: native safari mcp server for ai agents It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCPSafari?

Follow the installation instructions on the MCPSafari GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCPSafari?

MCPSafari works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCPSafari free to use?

Yes, MCPSafari is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Browser Automation MCP Servers

Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcpsafari": { "command": "npx", "args": ["-y", "mcpsafari"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCPSafari?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides