Agent skill · software engineering · sundial-org
apple-contacts
Look up contacts from macOS Contacts.app. Use when resolving phone numbers to names, finding contact info, or searching the address book.
Why this skill is useful
Adds specific AppleScript commands for querying macOS Contacts.app that the AI wouldn't reliably generate on its own.
What it needs
About 1k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Apple Contacts Query Contacts.app via AppleScript. Quick Lookups Full Contact Info ⚠️ Don't use first person whose — buggy. Use this pattern: Phone Lookup ⚠️ Exact string match required — must match stored format exactly. Stored Search Works? -------- -------- -------- +1XXXXXXXXXX +1XXXXXXXXXX ✅ +1XXXXXXXXXX XXXXXXXXXX ❌ Try with +1 prefix first. If fails, search by name instead. Name Search Case-insensitive Partial match with contains Exact match: use is instead of contains Output Returns comma-separated: name, phone1, [phone2...], email1, [email2...] No match = empty output (not an error).
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/apple-contacts