Skip to main content
Glama
MCP Safari Server

MCP Safari Server

MCP Safari Server

License: MIT MCP Protocol

A Model Context Protocol (MCP) server that provides programmatic control of Safari browser on macOS. Perfect for web automation, testing, and debugging with AI assistants like Claude.

Overview

The Safari MCP Server enables AI assistants to interact with Safari browser through a standardized protocol. It provides tools for navigation, element interaction, JavaScript execution, and page monitoring, making it ideal for:

  • πŸ€– AI-assisted web development and debugging

  • πŸ§ͺ Automated testing and QA

  • πŸ“Š Web scraping and data extraction

  • πŸ” Real-time error monitoring

  • πŸ“Έ Visual regression testing

Related MCP server: MCP Safari Server

Features

  • Navigate: Open URLs in Safari

  • Execute JavaScript: Run JS code in the current page context

  • Get Page Info: Retrieve current URL and page title

  • Take Screenshots: Capture the current Safari window

  • Console Logs: Capture and retrieve console.log, console.error, and console.warn messages

  • Page Navigation: Refresh, go back, or go forward in browser history

  • Automatic Error Monitoring: Monitor JavaScript errors and send them to Claude Code for immediate fixing

  • Click Elements: Click on page elements using CSS selectors

  • Type Text: Fill in forms and input fields

  • Scroll: Scroll to specific elements or positions

  • Select Options: Choose options from dropdown menus

  • Get Element Text: Extract text content from page elements

  • Wait for Elements: Wait for elements to appear before interacting

Installation

  1. Install dependencies:

cd mcp-safari-server
npm install
  1. Build the server:

npm run build

Configuration

Add this server to your Claude configuration file (.mcp.json or claude-code-config.json):

{
  "mcpServers": {
    "safari": {
      "command": "node",
      "args": ["/path/to/mcp-safari-server/dist/index.js"],
      "env": {}
    }
  }
}

Or for development:

{
  "mcpServers": {
    "safari": {
      "command": "npx",
      "args": ["tsx", "/path/to/mcp-safari-server/src/index.ts"],
      "env": {}
    }
  }
}

Usage

Once configured, Claude can use the following tools:

navigate

Navigate Safari to a URL:

Use the safari navigate tool to open https://example.com

execute_script

Execute JavaScript in the current page:

Use the safari execute_script tool to run: document.querySelector('h1').textContent

get_page_info

Get information about the current page:

Use the safari get_page_info tool to see the current URL and title

take_screenshot

Take a screenshot of the current Safari window:

Use the safari take_screenshot tool to capture the current page

get_console_logs

Retrieve console logs from the page:

Use the safari get_console_logs tool to see any console messages

refresh_page

Refresh the current page:

Use the safari refresh_page tool

go_back / go_forward

Navigate through browser history:

Use the safari go_back tool to go to the previous page

start_error_monitoring

Start monitoring JavaScript errors and automatically send them to Claude Code:

Use the safari start_error_monitoring tool

Options:

  • interval: Check interval in milliseconds (default: 2000)

  • autoSendToClaude: Automatically send errors to Claude Code (default: true)

stop_error_monitoring

Stop error monitoring:

Use the safari stop_error_monitoring tool

click_element

Click on an element in the page:

Use the safari click_element tool with selector "#submit-button"
Use the safari click_element tool with selector "a.nav-link" and waitForNavigation true

type_text

Type text into an input field:

Use the safari type_text tool with selector "#email" and text "user@example.com"
Use the safari type_text tool with selector "#password" and text "mypassword" and clearFirst false

scroll_to

Scroll to an element or position:

Use the safari scroll_to tool with selector "#footer"
Use the safari scroll_to tool with y 500 and behavior "smooth"

select_option

Select an option from a dropdown:

Use the safari select_option tool with selector "#country" and value "US"
Use the safari select_option tool with selector "#size" and text "Large"
Use the safari select_option tool with selector "#priority" and index 2

get_element_text

Get the text content of an element:

Use the safari get_element_text tool with selector "h1"
Use the safari get_element_text tool with selector ".error-message"

wait_for_element

Wait for an element to appear:

Use the safari wait_for_element tool with selector "#loading-complete"
Use the safari wait_for_element tool with selector ".modal" and timeout 5000

## Error Monitoring Feature

The Safari MCP server can automatically monitor JavaScript errors in your web application and send them to Claude Code for immediate fixing. This creates a powerful development workflow where:

1. You develop your web app
2. Safari MCP monitors for JavaScript errors
3. When errors occur, they're automatically sent to Claude Code
4. Claude can analyze the errors and suggest or implement fixes

### How Error Monitoring Works

When you start error monitoring, the server:

1. Injects JavaScript into the Safari page to capture:
   - Unhandled errors (window.onerror)
   - Unhandled promise rejections
   - Console.error calls

2. Checks for new errors at the specified interval (default: every 2 seconds)

3. If errors are found and Claude Code is active, sends a notification containing:
   - Error type and message
   - File location and line/column numbers
   - Stack traces
   - Current page URL
   - Timestamp

4. Claude Code receives the notification and can prompt you to fix the errors

### Example Workflow

1. Start your development server
2. Navigate to your app in Safari using the `navigate` tool
3. Start error monitoring with `start_error_monitoring`
4. As you interact with your app, any JavaScript errors will be captured
5. Claude Code will receive notifications about errors and can help fix them
6. Stop monitoring with `stop_error_monitoring` when done

## Requirements

- macOS (uses AppleScript to control Safari)
- Safari browser
- Node.js 16+

## Security Note

This server executes AppleScript commands to control Safari. Only use it in trusted environments and be careful with the JavaScript code you execute.

## Troubleshooting

1. **Safari automation permission**: You may need to grant Terminal/your IDE permission to control Safari in System Preferences > Security & Privacy > Privacy > Automation.

2. **Script execution errors**: Check that Safari is installed and not blocked by any security software.

3. **Console log capture**: The console log capture feature injects a script into the page. Some pages with strict Content Security Policies might block this.

Available Tools

16 tools
click_elementC

Click on an element in the page using CSS selector

Inputs: selector (required), waitForNavigation.

execute_scriptB

Execute JavaScript in the current Safari page

Inputs: script (required).

get_console_logsB

Get console logs from the current page

Inputs: no named parameters.

get_element_textB

Get the text content of an element

Inputs: selector (required).

get_page_infoA

Get information about the current page (URL, title, etc.)

Inputs: no named parameters.

go_backA

Navigate back in Safari history

Inputs: no named parameters.

go_forwardA

Navigate forward in Safari history

Inputs: no named parameters.

refresh_pageA

Refresh the current Safari page

Inputs: no named parameters.

scroll_toC

Scroll to a specific element or position

Inputs: x, y, behavior, selector.

select_optionC

Select an option from a dropdown

Inputs: selector (required), text, index, value.

start_error_monitoringC

Start monitoring Safari for JavaScript errors and optionally send them to Claude Code

Inputs: interval, autoSendToClaude.

stop_error_monitoringB

Stop monitoring Safari for JavaScript errors

Inputs: no named parameters.

take_screenshotB

Take a screenshot of the current Safari window

Inputs: filename.

type_textB

Type text into an input element

Inputs: text (required), selector (required), clearFirst.

wait_for_elementC

Wait for an element to appear on the page

Inputs: selector (required), timeout, visible.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 16 tools

    Disambiguation5/5

    Each tool targets a distinct action (navigation, interaction, inspection, monitoring). There is no overlap; for example, click_element, type_text, and select_option are clearly different operations.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern in snake_case (e.g., click_element, get_page_info, start_error_monitoring). Even directional commands like go_back adhere to the convention.

    Tool Count5/5

    16 tools is well-scoped for a Safari browser automation server. It provides sufficient functionality without being overwhelming.

    Completeness4/5

    The tool set covers essential browser operations: navigation, element interaction, page information, screenshots, script execution, console logs, and error monitoring. Minor gaps exist (e.g., no alert handling or window resizing), but core workflows are well-supported.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides AI assistants with Safari browser automation and developer tools access, enabling LLMs to control Safari, access console logs, monitor network activity, and perform browser automation tasks.
      13
      9 npm
      33
      MIT
    • -
      license
      A
      quality
      Not graded
      maintenance
      A server that provides AI assistants programmatic control of Safari browser on macOS for web automation, testing, and debugging.
      16
      1
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables local macOS automation via the Model Context Protocol, allowing file operations, system monitoring, shell commands, clipboard access, and screenshots with configurable security restrictions.
      14
      MIT