findmy

Automate Apple device and AirTag location capture via FindMy and AppleScript.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Aevonix/colony-ai --skill findmy-aevonix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/Aevonix/colony-ai/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/Aevonix/colony-ai --skill findmy-aevonix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates locating Apple devices and AirTags on macOS by using FindMy with AppleScript and screen capture, addressing the lack of a native CLI or API.

Core Features & Use Cases

  • AppleScript + Screenshot workflow opens FindMy, selects the Devices tab, and captures location data for analysis.
  • Peekaboo UI automation (optional) offers more reliable interaction and annotation of device screens.
  • Periodic tracking workflow to monitor AirTag movements over time by capturing screenshots at intervals.

Quick Start

Open FindMy, switch to the Devices tab, and begin automated location captures for analysis.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I automate locating Apple devices and AirTags on macOS?

You can automate locating Apple devices on macOS by using AppleScript to open the FindMy app, switch to the Devices tab, and capture screenshots for visual location data extraction.

Can I extract FindMy location data without a native CLI or API?

Yes, you can extract FindMy location data by automating the macOS UI with AppleScript and using vision analysis to read on-screen device locations from captured screenshots.

What macOS permissions are required to automate FindMy tracking?

Automating FindMy tracking requires macOS screen recording permission to capture interface screenshots, while optional Peekaboo integration enhances UI automation reliability for selecting devices.

How do I monitor AirTag movement over time on a Mac?

You can monitor AirTag movement over time by running a periodic tracking workflow that captures FindMy screenshots at set intervals, allowing you to track location changes sequentially.

Does the FindMy automation approach work for both Apple devices and AirTags?

Yes, the AppleScript and screenshot workflow works for both Apple devices and AirTags by navigating the FindMy app interface and analyzing the captured on-screen location data.

Why use screen capture and vision analysis instead of a FindMy API?

Screen capture and vision analysis are used because Apple lacks a native FindMy CLI or API, making UI automation with AppleScript and visual data extraction the primary workaround.