findmy

Automate the Find My UI on macOS to locate Apple devices and AirTags.

Updated May 3, 2026

Search Tags:#macos #screen-capture #ui-automation #findmy #airtag #location-tracking

Ready to run

npx skills add https://github.com/JuanMS20/solviora-agent --skill findmy-juanms20

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/JuanMS20/solviora-agent/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/JuanMS20/solviora-agent --skill findmy-juanms20

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Apple devices and AirTags lack a native CLI, making location checks tedious. This skill uses AppleScript and screen capture to automate the Find My app and extract device locations.

Core Features & Use Cases

AppleScript + Screenshot (Basic): Open Find My, navigate, and capture a screenshot for analysis.
Peekaboo UI Automation (Recommended): Use Peekaboo to interact with the UI, annotate, and capture detail views for reliable extraction.
Workflow for tracking AirTag location over time: Periodically capture UI to build a location history and route.

Quick Start

Open Find My, then run the automation to capture a location read and feed it to your analysis step.

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 over time using macOS?▼

You can track AirTag location over time on macOS by periodically automating the Find My UI to capture screenshots and build a location history. This skill uses AppleScript and optional Peekaboo automation to extract and record movement data.

Can I extract Apple device locations from the Find My app without a CLI?▼

Yes, you can extract Apple device locations without a native CLI by automating the Find My app via AppleScript and screen capture. This skill navigates the UI, captures visual data, and reads on-screen location details for analysis.

Do I need Peekaboo automation to read Find My data on macOS?▼

Peekaboo automation is recommended but optional for reading Find My data. While the basic method uses AppleScript and screenshots, Peekaboo provides reliable UI interaction, annotates detail views, and improves data extraction accuracy.

What's the best way to automate Find My UI for AirTag tracking?▼

The best way to automate Find My UI for AirTag tracking is using Peekaboo UI automation. It interacts with on-screen elements, annotates detail views, and captures reliable screenshots, whereas the basic method only captures unannotated screen images.

Why does Find My automation rely on screen capture instead of direct API access?▼

Find My automation relies on screen capture because Apple devices and AirTags lack a native CLI for direct API access. Automating the visual UI via AppleScript and reading on-screen data bypasses the absence of programmatic endpoints.