baepsae — Claude Code MCP server: setup
A local MCP server for controlling iOS Simulator and macOS apps through a TypeScript layer backed by a native Swift bridge.
claude mcp add baepsae -- npx -y mcp-baepsaeWhat baepsae does
baepsae lets an agent inspect and operate iOS Simulator and macOS applications. Its tools cover UI analysis, taps, and right-click actions, while simulator work can also use xcrun simctl. Selector searches using an id or label target app content by default; all: true includes the Simulator’s own chrome.
The package combines a TypeScript MCP layer with the Swift native binary baepsae-native. It requires macOS 14+, Xcode or Xcode Command Line Tools, Node.js 18+, and Swift 6+. Linux and Windows are excluded because the native bridge depends on macOS frameworks.
UI inspection and input control need Accessibility access for the process that launches the server, such as node, a terminal, or the MCP client. Restarting that process may be necessary after changing the permission.
What it helps with
- inspect an app screen in iOS Simulator
- locate a control by
idorlabel - tap a macOS application element
- send simulator actions through
xcrun simctl
Example prompts for the agent
- Inspect the current iOS Simulator screen and list the controls you can find.
- Find the control with
idlogin-buttonand activate it. - Open the context menu for the selected element with a right-click.
How to install baepsae
Platform CLI
claude mcp add baepsae -- npx -y mcp-baepsaePlatform CLI
codex mcp add baepsae -- npx -y mcp-baepsaeConfig file
{
"mcpServers": {
"baepsae": {
"command": "npx",
"args": [
"-y",
"mcp-baepsae"
]
}
}
}Config file
{
"servers": {
"baepsae": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-baepsae"
]
}
}
}Platform CLI
gemini mcp add baepsae npx -y mcp-baepsaeStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about baepsae
How do I install baepsae in Claude Code?
Run claude mcp add baepsae -- npx -y mcp-baepsae.
What does baepsae do?
It exposes MCP tools for inspecting and controlling iOS Simulator and macOS apps, including UI analysis, taps, and right-click actions.
What is required for UI automation?
You need macOS 14+, Xcode or Xcode Command Line Tools, Node.js 18+, and Swift 6+. The launching runtime or client also needs macOS Accessibility access.
