Does this skill work on Windows or Linux?

No, this skill specifically targets macOS as it relies on the native AppleScript and JXA (JavaScript for Automation) frameworks built into the operating system.

What permissions are required to use this skill?

The host application running Claude Code must have Contacts access granted in macOS System Settings under Privacy & Security.

Can I manage contact groups with this skill?

Yes, the skill includes patterns for querying existing groups, creating new ones, and managing person-to-group membership with duplicate prevention.

How does it handle multi-value fields like multiple emails or phones?

It uses a constructor-based JXA pattern to create new multi-value elements and push them into the respective contact arrays before persisting the changes.

Does it support Python-based automation?

Yes, it includes references and installation guidance for PyXA, allowing you to use Python for macOS Contacts automation alongside JXA.

macOS Contacts Automation

Name: macOS Contacts Automation
Author: SpillwaveSolutions

bySpillwaveSolutions

•

Productivity & Workflow

Automates macOS Contacts management using JXA and AppleScript for advanced querying, CRUD operations, and group organization.

About

The macOS Contacts Automation skill empowers Claude to programmatically manage the Apple Address Book through JXA-first patterns and AppleScript dictionary discovery. It provides robust workflows for querying specific contacts, managing multi-value fields like emails and phone numbers, and handling group memberships while accounting for TCC permissions and persistence checks. This skill is ideal for developers building local automation scripts, CRM synchronization tools, or custom contact management workflows directly on macOS using native system APIs.

Key Features

Defensive group management and membership handling
Full CRUD operations for contacts and multi-value fields
Support for PyXA and hybrid filtering methods
Objective-C bridge fallbacks for advanced data types like photos
JXA-first implementation with AppleScript dictionary discovery
3 GitHub stars

Use Cases

Synchronizing local macOS contacts with external CRM or database data
Automating the creation of detailed contact cards from structured text or email data
Mass-updating contact groups or tagging specific sets of users based on criteria

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add spillwavesolutions/automating-mac-apps-plugin automating-contacts

For use in Claude.ai and ChatGPT

Download Skill

GitHub