ネイティブのSafari MCPサーバーで、macOSでSafariをログインできます。 Claude Code、Codex、Cursor、OpenCode、oh-my-piなどのMCP互換クライアントと連携します。

あなたのエージェントは、既存のログイン、クッキー、履歴から始まります。 サインインページを開き、作業を行います。

• Safariでサイトをテストします。 エージェントは、Safariユーザーのブラウザでフォーム、メニュー、ドラッグアンドドロップをチェックして確認します。
• UID(スナップショットから)、CSS、テキスト、または座標によるターゲット要素。 アプリケーションの状態を更新する setter で React フォームを記入します。
• 何が起きたかを確認します。 コンソールとネットワークのアクティビティを読んで、スクリーンショットをディスクに保存して、エージェントのコンテキストを画像データで満たさずに確認できます。
• DOM タスクをバックグラウンドで実行します。 ネイティブタイピング、キープレス、ホバー、ドラッグは、フロントとアクセシビリティ権限でSafariを必要とします。

実際のサイト上のQAは、無視されたクリックとファイルを見逃したゾーンをドロップするメニューの修正を含むツールを形作りました。

Swift と Manifest V3 Safari の拡張機能が搭載されています。 macOS 14 +とSafari 17 +が必要です。 ソースからビルドするXcodeのみが必要です。

クイックスタート

##1. インストール

MCPSafari: Your favorite browser, ready for agents

A native Safari MCP server for your real, logged-in Safari on macOS. Works with any MCP-compatible client, including Claude Code, Codex, Cursor, OpenCode, and oh-my-pi.

Your agent starts with your existing logins, cookies, and history. Open a signed-in page and get to work.

• Test your site in Safari. Let your agent check forms, menus, and drag-and-drop in the browser your Safari users will see.
• Target elements by UID (from a snapshot), CSS, text, or coordinates. Fill React forms with setters that update application state.
• Check what happened. Read console and network activity, and save screenshots to disk for review without filling the agent’s context with image data.
• Run DOM tasks in the background. Native typing, key presses, hover, and drag need Safari in front and Accessibility permission.

QA on real sites has shaped the tools, including fixes for menus that ignored clicks and drop zones that missed files.

Built with Swift and a Manifest V3 Safari extension. Requires macOS 14+ and Safari 17+. Xcode is only needed to build from source.

Quick start

1. Install

brew trust epistates/tap
brew install --cask epistates/tap/mcp-safari

brew trust is needed once: installing a cask auto-trusts the cask, but not the mcp-safari-server formula it depends on, and without it the install stops at Refusing to load formula epistates/tap/mcp-safari-server from untrusted tap.

Open MCPSafari.app once so Safari picks up the extension, then enable MCPSafari Extension in Safari → Settings → Extensions. Grant access to the sites you want your agent to use.

Homebrew installs the published release. This README and the tool reference describe main, which may include unreleased features. Check Releases for your version.

2. Connect your client

For Claude Code:

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

For Codex CLI:

codex mcp add mcp-safari -- mcp-safari

Start a new client session after adding the server. For Claude Desktop, Cursor, and other clients, see client configuration.

3. Try it

Ask your agent:

Open example.com in a new Safari tab, read the page heading, and take a screenshot.

The heading should be “Example Domain”. If the connection fails, see troubleshooting. On versions that include it, mcp-safari doctor checks the installation without changing it.

Before you use it