findmy

Automate Find My on macOS to read Apple device and AirTag locations via AppleScript.

13|3|Updated May 12, 2026
One-click install
npx skills add https://github.com/kevinnft/ai-agent-skills --skill findmy-kevinnft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/kevinnft/ai-agent-skills/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/kevinnft/ai-agent-skills --skill findmy-kevinnft

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Finding the current location of Apple devices and AirTags can be challenging when Find My provides no official CLI. This skill automates the process using AppleScript to open Find My and capture screen content for location data.

Core Features & Use Cases

  • AppleScript automation to launch Find My, switch to the Devices or Items tab, and read on-screen locations.
  • Optional Peekaboo UI automation for more reliable interaction with the Find My interface.
  • Workflow to periodically track an AirTag's location over time, enabling patrol-style monitoring.
  • Clear limitations and privacy considerations to keep usage safe and compliant.

Quick Start

Open FindMy on macOS, run the provided automation to access device locations, and optionally enable Peekaboo to improve reliability.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I track Apple devices and AirTags on macOS without a command line interface?

You can track Apple devices and AirTags on macOS by using AppleScript automation to launch the Find My app, navigate to the Devices or Items tab, and capture on-screen location data. This bypasses the lack of an official CLI.

Can I automate periodic location tracking for an AirTag over time?

Yes, you can automate periodic AirTag location tracking over time using an AppleScript workflow, enabling patrol-style monitoring by repeatedly querying the Find My app interface for current item locations.

What are the prerequisites for automating Find My to locate devices on macOS?

Automating Find My requires macOS with the Find My app installed, an active iCloud sign-in, and screen recording permissions. Optional Peekaboo UI automation can be added to improve interaction reliability.

Is there a way to improve the reliability of AppleScript when reading device locations from Find My?

Yes, you can improve AppleScript reliability when reading device locations by enabling Peekaboo UI automation, which provides more robust interaction with the Find My interface to capture accurate location data.

What limitations exist when using AppleScript to extract location data from Find My?

Limitations include relying on screen content reading rather than direct API access, requiring continuous screen recording permissions, and needing optional Peekaboo for reliable UI interaction, alongside strict privacy compliance considerations.