MCP server for macOS UI automation with Claude Desktop/Code integration, plus Python library and CLI interfaces
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"macos-ui-automation-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# 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.** [](https://www.python.org/downloads/) [](https://modelcontextprotocol.io/) [](https://opensource.org/licenses/MIT) ## 🎯 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 ```bash 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: ```json { "mcpServers": { "macos-ui-automation": { "command": "uv", "args": [ "--directory", "/absolute/path/to/macos-ui-automation-mcp", "run", "macos-ui-automation-mcp" ] } …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.