Playwright MCP for macOS 🎭

Like Playwright, but for native macOS applications. Control any Mac app with natural language through Claude - perfect for developing and testing Mac applications with AI assistance.

🎯 What is this?

This is an MCP (Model Context Protocol) server that gives Claude the ability to see and interact with any macOS application - just like Playwright does for web browsers, but for native Mac apps.

Perfect for:

• 🧪 Testing Mac applications - “Test the login flow in my app”
• 🔍 App development - “Check if all buttons are properly labeled”
• 🤖 UI automation - “Fill out this form and submit it”
• 📱 App exploration - “Show me all the interactive elements in Finder”

🚀 Quick Start

1. Install

git clone https://github.com/mb-dev/macos-ui-automation-mcp.git
cd macos-ui-automation-mcp
uv sync

2. Set Up Accessibility Permissions

⚠️ Critical: Enable accessibility for your parent application:

• If using Terminal: Add Terminal to System Settings → Privacy & Security → Accessibility
• If using VS Code: Add VS Code to System Settings → Privacy & Security → Accessibility
• If using Claude Code: Add Claude Code to System Settings → Privacy & Security → Accessibility

The parent app needs permission because it’s the one actually executing the MCP server.

3. Configure Claude Code

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "macos-ui-automation": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/macos-ui-automation-mcp",
        "run",
        "macos-ui-automation-mcp"
      ]
    }
  }
}

4. Start Automating!

Now you can ask Claude things like:

• “Find all buttons in the Calculator app”
• “Click the submit button in my app”
• “Click the screenshot button to capture the current window”
• “Test the login flow by filling in credentials and clicking submit”

🛠 Available Tools