Locate Your AirTags and Family with the Apple Find My Skill

Ever wanted to ask your AI assistant "Where are my keys?" and get an actual answer? The Apple Find My skill for Clawdbot makes this possible by giving your agent the ability to interact with Apple's native Find My app on macOS. No third-party APIs, no credential sharing—just local UI automation that keeps your location data private.

What This Skill Does

The Find My skill uses Peekaboo (a macOS UI automation tool) to control the Find My app, allowing your agent to:

Locate AirTags and items (keys, wallet, backpack)
Track devices (MacBooks, iPhones, iPads)
Check on family members (if they're sharing location with you)
Play sounds on lost items to help find them
Take screenshots of maps showing locations

The beauty of this approach is that everything happens locally. Your location data never leaves your Mac.

Installation

First, install the skill via ClawdHub:

npx clawhub@latest install apple-find-my-local

Prerequisites

Before you can use the skill, you'll need:

macOS (this skill is Mac-only)
OpenClaw.app running (provides the Peekaboo bridge)
Find My.app open on your Mac
Permissions granted: OpenClaw.app needs Screen Recording and Accessibility permissions

To grant permissions:

Go to System Settings → Privacy & Security → Screen Recording → Enable for OpenClaw
Go to System Settings → Privacy & Security → Accessibility → Enable for OpenClaw

You'll also need Peekaboo installed. If you haven't installed it yet:

npx clawhub@latest install peekaboo

Usage Examples

All scripts should be run from the skill directory. Let's walk through common scenarios.

Finding Your AirTags

Want to see all your AirTags and items? First, list them:

./scripts/fm-list.sh items

This switches to the Items tab and takes a screenshot showing your AirTags in the sidebar. The output tells you each item's position (1st, 2nd, 3rd, etc.).

Once you identify which position your keys are at (say, position 2), locate them:

./scripts/fm-locate.sh 2 items

This selects the item and captures a screenshot of the map showing its location.

Playing a Sound on Lost Items

Can't find your AirTag-equipped keys even though you know they're nearby? Make them chirp:

./scripts/fm-play-sound.sh 2

This attempts to click the "Play Sound" button for the 2nd item. Note: You may need to have the info panel open first—if the script can't find the button, try clicking the ⓘ icon on the map popup manually.

Checking Family Locations

If family members share their location with you via Find My, you can check on them too:

./scripts/fm-list.sh people
# View the screenshot to see who's listed

./scripts/fm-locate.sh 1 people
# Shows the first person's location

Getting Device Info

Want to see where your other devices are?

./scripts/fm-list.sh devices
./scripts/fm-locate.sh 3 devices  # Locate your 3rd device

Pro Tips

Know your positions: Since Find My doesn't expose item names via accessibility APIs, you need to select items by position (1st, 2nd, 3rd). Run fm-list.sh first to see which position corresponds to which item.

Exclusive control: While the skill is running, it takes control of your mouse/keyboard. Don't try to use your Mac simultaneously—let the automation complete.

Window moved? If clicks aren't registering, the Find My window may have moved. Run ./scripts/fm-window.sh to get fresh coordinates.

Screenshots are temporary: Screenshots are saved to /tmp/ by default. If you need to keep them, specify a path: ./scripts/fm-screenshot.sh ~/Desktop/findmy.png

Privacy Considerations

This skill sees whatever's visible in your Find My app, including:

Shared locations of friends/family
All devices in your Family Sharing group
All your AirTags and items

However, it's purely local UI automation—no data goes to third-party servers. All operations are visible on your screen as they happen.

Conclusion

The Apple Find My skill brings real-world utility to your AI assistant. Instead of fumbling through apps when you're running late and can't find your keys, just ask your agent. It's one of those quality-of-life improvements that makes having an AI assistant feel genuinely useful.

Links: