monocle
Allows AI agents to test iOS mobile apps by interacting with iOS simulators through tools like tap, swipe, type, screenshot, element inspection, and session recording.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Monocle
Playwright for Mobile — Give AI agents the ability to test any iOS mobile app.
Monocle is an open-source MCP server + visual dashboard that lets AI agents (Claude Code, Cursor, etc.) interact with iOS simulators through 21+ tools: tap, swipe, type, screenshot, inspect elements, wait for conditions, record sessions, and more.
Architecture
┌─────────────────────────────────────────────────────┐
│ Monocle Dashboard (Next.js) │
│ Live Simulator View + Agent Chat + Action Timeline │
└───────────────────────┬─────────────────────────────┘
│ HTTP + WebSocket (:7200)
┌───────────────────────▼─────────────────────────────┐
│ Monocle Server (Node.js) │
│ MCP Server (stdio+HTTP) + REST API + WS Streaming │
│ 21+ tools • Element refs (@e1) • Session recording │
└───────────┬────────────────────────┬────────────────┘
│ │
idb_companion xcrun simctl
(accessibility, (screenshots,
tap, swipe, type) recording, lifecycle)Related MCP server: iOS Device Control MCP Server
Quick Start
# Prerequisites: Xcode 15+, Node.js 20+, idb_companion
npm install
npm run dev
# Or use via MCP (stdio mode for Claude Code):
npx tsx packages/server/src/index.ts --stdioMCP Configuration
{
"mcpServers": {
"monocle": {
"command": "npx",
"args": ["tsx", "/path/to/monocle/packages/server/src/index.ts", "--stdio"]
}
}
}Tools (21+)
Category | Tools |
Screen |
|
Interact |
|
Inspect |
|
Wait |
|
Device |
|
Record |
|
Element Refs
Monocle assigns short refs (@e1, @e2, ...) to every UI element. Use them anywhere:
Agent: "tap @e3" → taps the Login button
Agent: "type into @e5 'hello@example.com'" → types into email fieldRefs are stable within a session — same element keeps the same ref across calls.
Packages
packages/server— MCP server, iOS bridges, streaming, sessionspackages/dashboard— Next.js visual dashboardpackages/cli— CLI (monocle start,monocle devices,monocle screenshot)
Prerequisites
macOS with Xcode 15+
At least one iOS Simulator booted
idb_companioninstalled (brew install idb-companion)Python 3.11 venv with
fb-idb(for accessibility tree)
License
MIT — Pivot Studio AI
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Related MCP Connectors
Let your AI agent control real iPhones: screenshots, tap, swipe, type and open apps.
Cloud iPhone Simulators for AI agents: build the Xcode project, read the screen, tap by label, test.
Build, run, and inspect iOS apps in disposable hosted Simulators from cloud coding agents.
Cloud iPhones and Macs with Xcode for AI agents: build, run and test iOS apps, use the screen.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables interaction with iOS simulators by providing tools to inspect UI elements, control UI interactions, and manage simulators through natural language commands.1713,665 npm2,217MIT
- AlicenseNot gradedqualityDmaintenanceEnables comprehensive control of iOS simulators and real devices through AI assistants, supporting app management, UI automation, screenshots, media operations, and location simulation for iOS development and testing workflows.8MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to control real iPhones and simulators on macOS, allowing for UI interaction, testing, and automation.90 npm98MIT
- AlicenseBqualityDmaintenanceEnables AI assistants to control iOS simulators through WebDriverAgent, supporting taps, swipes, typing, screenshots, recording, and app actions with a real-time dashboard for visual feedback.36Apache 2.0