automating-contacts

What problem does it solve?

This Skill helps you automate macOS Contacts operations—finding people, creating or updating records, and managing group membership—without manually clicking through the Contacts app.

Core Features & Use Cases

• Query and filter contacts using Contacts.app’s AppleScript dictionary as the source of truth, then implementing the same concepts in JXA with specifier reads.
• Create and upsert contact records with robust make + property assignment patterns, including multi-value fields like emails, phones, and addresses.
• Manage groups defensively by checking for existence to avoid duplicate membership errors and persisting changes reliably via Contacts.save().
• Handle tough cases such as TCC permission requirements and image/photo bridge failures with ObjC/clipboard fallback guidance.

Quick Start

Grant Contacts permission if prompted, then ask the skill to upsert a contact by email and add it to a group on your Mac.