findmy

Locate Apple devices and AirTags via FindMy on macOS using AppleScript and screen capture.

2|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/AlexiosBluffMara/mercury --skill findmy-alexiosbluffmara
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/AlexiosBluffMara/mercury/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/AlexiosBluffMara/mercury --skill findmy-alexiosbluffmara

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Track Apple devices and AirTags using FindMy on macOS, enabling automation where a CLI is not available.

Core Features & Use Cases

  • AppleScript-based FindMy control to open the app and query device locations.
  • Screen capture-driven location reading when UI presents location data.
  • Optional UI automation with tools like Peekaboo for more reliable interactions in multi-step workflows.
  • Use cases include locating devices, monitoring AirTag movements, and building simple location logs on macOS.

Quick Start

Run an AppleScript to open FindMy and capture a screenshot for location extraction.

Frequently Asked Questions about findmy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track AirTag location on macOS when there is no command line interface?

Track AirTag locations on macOS by using AppleScript to open FindMy and screen capture to read the on-screen location data. This automation method enables device tracking and location logging without needing a native CLI.

What permissions are required to automate FindMy device tracking on macOS?

Automating FindMy device tracking on macOS requires an active FindMy account signed in, screen recording permission for capturing locations, and optional UI automation tools like Peekaboo to handle multi-step interactions reliably.

Can I use AppleScript to extract location data from the FindMy app?

Yes, you can use AppleScript to control the FindMy app on macOS and extract location data. The script opens the application and queries devices, using screen capture to read and parse the displayed location information.

What is the best way to automate AirTag movement monitoring without a FindMy CLI?

The best way to monitor AirTag movements without a FindMy CLI is through scripted UI automation. By combining AppleScript to navigate the app and screen capture to extract location text, you can build simple location logs on macOS.

Does FindMy automation on macOS work for tracking multiple Apple devices?

FindMy automation on macOS supports tracking multiple Apple devices and AirTags. It uses AppleScript to query the app interface and screen capture to read location data, allowing you to identify device locations and monitor asset movements.

Why is screen capture needed to read FindMy locations on macOS?

Screen capture is needed to read FindMy locations on macOS because Apple provides no CLI for the application. Scripted UI automation opens the interface, and screen capture extracts the location data visually presented on your screen.