The Owlery Works™

Owl Watch Simulator MCP · the OwleryWorks Library

Let your coding agent
see the watch.

An open-source MCP server for the Mac. Your AI agent builds the watch app, runs it in Garmin’s simulator, reads the screen and presses the buttons, so it checks its own work by looking.

Free MIT licence Mac For Claude Code and other MCP clients

Open source on GitHub. Get Owl Watch Simulator MCP: the code, the manual and the issues.

How it works How to set it up Privacy policy
A round watch screen in the simulator: Town Hall Station, with Trains, Light Rail and Buses, each showing its next departure.

How it works

Build, look, press, look again.

  1. Your agent asks for a build, a look or a tap
  2. The MCP server on your Mac: builds, launches, presses
  3. The simulator your watch app, running

and every action comes back with

  • The screen
  • Its text, with positions
  • The app’s log
So the agent can tap “Trains” by name and wait for the next screen, instead of asking you for a screenshot.

What your agent sees

A picture, and the words on it.

On the left, the watch screen at Town Hall Station. On the right, what one screenshot call returned for it: each piece of text with its position, such as Trains at 130, 139, and the next call, tap_text Trains.

A real capture, and the text that call returned.

Runs on your Mac

It talks only to the simulator.

What it sees, it hands to your agent, which sends it to the model the agent uses. No account, no telemetry, nothing sent to us.

Read the privacy policy
Owl Watch Simulator MCP requirements
MacmacOS 14 or later.
ToolsNode.js 20, Garmin’s Connect IQ SDK, Java and Xcode Command Line Tools.
PermissionsAccessibility and Screen Recording, for the app you start it from.
InstallFrom npm: npx -y owl-watch-simulator-mcp. The README on GitHub has the steps.

Something not working?

Open an issue on GitHub, or raise a case here, with or without an email address.

Get support Check an existing case

Provided as is, with no warranty or guarantee. You use it at your own risk: we accept no responsibility for what it, or your agent, does. Not affiliated with or endorsed by Garmin. Connect IQ is a trademark of Garmin Ltd.