# Apple Safari

> Apple Safari is an open-source MCP server for browser automation. Let an agent read Safari history, tabs and reading list, with writes switched off. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Website:** https://cupertino.mgcrea.io
- **Repository:** https://github.com/mgcrea/cupertino/tree/HEAD/packages/safari
- **MCP Registry name:** io.github.mgcrea/mcp-apple-safari
- **Categories:** browser automation, productivity
- **Listing updated:** 2026-11-14

## About

Safari access is split into three lanes that see different things. File access (Full Disk Access) reads the past: history, bookmarks and the Reading List. Apple Events (an Automation grant) lists the tabs open now. A Safari extension reads page text and elements, needs no system grant, and is allowed one website at a time.

Risky capabilities are separate opt-in gates. Write tools are not even registered unless APPLE_SAFARI_ALLOW_WRITES is set, so an agent never sees them. Reading one-time codes, recording page network traffic, and reading cookies each have their own switch, and cookies are readable only for domains listed in APPLE_SAFARI_COOKIE_HOSTS. Credential fields stay redacted.

It ships as the @mgcrea/mcp-apple-safari npm package, part of the unofficial, MIT-licensed Cupertino bundle for macOS 26 or later.

## Features

- **Three access lanes:** History files, Apple Events and a per-site extension.
- **Writes off by default:** Mutating tools are not registered until you enable them.
- **Opt-in code reading:** One-time codes shown on a page need their own switch.
- **Network recording:** Lists what a page fetched, with credential headers masked.
- **Cookie allowlist:** Cookies are readable only for domains you name.
- **Diagnostics tool:** Reports which lanes work and why one does not.

## Good for

- Find a page you visited last week
- See which tabs are open before a task
- Check what is unread in the Reading List
- Read the text of the page in front of you

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-apple-safari -- npx -y @mgcrea/mcp-apple-safari
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-apple-safari": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-safari"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-apple-safari": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-safari"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-apple-safari": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-safari"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-apple-safari": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-safari"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-apple-safari": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-safari"
      ]
    }
  }
}
```

## Tools

- `apple_safari_search_history`: Search history by text or date range, with visit counts.
- `apple_safari_get_page`: Fetch one history item by reference.
- `apple_safari_list_tabs`: List tabs open now.
- `apple_safari_list_bookmarks`: Return the bookmark tree.
- `apple_safari_list_reading_list`: List saved items and which are unread.
- `apple_safari_read_page`: Return a captured page as text or HTML.
- `apple_safari_page_elements`: List what is clickable or typeable on a live page.
- `apple_safari_wait_for`: Wait for text to appear on or leave a page.
- `apple_safari_diagnostics`: Report which access lanes work.

## FAQ

### What macOS version is needed?

The Cupertino site says macOS 26 or later.

### Can the agent change Safari?

Only if you turn on APPLE_SAFARI_ALLOW_WRITES.

### Is it from Apple?

No, it is unofficial and not affiliated with Apple.

### How do I install it?

Run it with npx -y @mgcrea/mcp-apple-safari in your MCP client config.

### Is Apple Safari free?

Yes. Apple Safari is open source, so you can use and self-host it for free.

### How do I add Apple Safari to Claude Code?

Run this command in your terminal: claude mcp add mcp-apple-safari -- npx -y @mgcrea/mcp-apple-safari

### What are the best alternatives to Apple Safari?

The closest alternatives to Apple Safari are Browser Use, Scrapling MCP Server, Ha MCP, Concord MCP and Oya Browser.

## Alternatives

- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Mantis](https://ai-powered.com/mcp/mantis-2): Mantis is an open-source MCP server for browser automation.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/apple-safari
