automating-contacts

Installation
SKILL.md

Automating Contacts (JXA-first, AppleScript discovery)

Relationship to Other Skills

  • Standalone for Contacts: Use this skill for Contacts-specific operations (querying, CRUD, groups).
  • Reuse automating-mac-apps for: TCC permissions setup, shell command helpers, UI scripting fallbacks, and ObjC bridge patterns.
  • Integration: Load both skills when combining Contacts automation with broader macOS scripting.
  • PyXA Installation: To use PyXA examples in this skill, see the installation instructions in automating-mac-apps skill (PyXA Installation section).

Core Framing

  • Contacts dictionary is AppleScript-first; discover there, implement in JXA
  • Object specifiers: read with methods (name(), emails()), write with assignments
  • Multi-value fields (emails, phones, addresses) are elements; use constructor + .push()
  • Group membership: add ... to command or .people.push; handle duplicates defensively
  • TCC permissions required: running host must have Contacts access
Related skills

More from spillwavesolutions/automating-mac-apps-plugin

Installs
17
GitHub Stars
30
First Seen
Feb 1, 2026