apple-contacts

Automate macOS Contacts queries using AppleScript via osascript.

34|5|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/linanwx/nagobot --skill apple-contacts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-contacts
Source: https://github.com/linanwx/nagobot/tree/main/cmd/templates/skills/apple-contacts
Command: npx skills add https://github.com/linanwx/nagobot --skill apple-contacts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reading and querying macOS Contacts from automation scripts can be tedious; this skill provides ready-to-run AppleScript examples to list, search, and fetch contact details from the built-in Contacts app.

Core Features & Use Cases

  • List all contacts and their basic details.
  • Search contacts by name, phone, or email and retrieve full details.
  • Retrieve grouped and individual contact information for automation workflows.
  • Example use case: automatically generate a directory of client contacts for onboarding or outreach.

Quick Start

Run osascript commands to list, search, or get details from Apple Contacts.

Frequently Asked Questions about apple-contacts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate searching Apple Contacts using AppleScript?

You can automate searching Apple Contacts by running AppleScript commands via osascript. This allows you to query the built-in macOS Contacts app locally to find people by name, phone, or email.

Can I retrieve full contact details from macOS Contacts without network access?

Yes, you can retrieve full contact details locally without network access. The automation operates entirely on your Mac using osascript to query the built-in Contacts app.

What is the best way to list all contacts in the macOS Contacts app for an automation workflow?

The best way to list all contacts is using ready-to-run AppleScript examples. They enable you to retrieve grouped and individual contact information, which is useful for tasks like generating client directories.

Does automating Apple Contacts with AppleScript require any external dependencies?

No, automating Apple Contacts requires no external dependencies or network access. It runs locally on macOS using the built-in osascript tool to read and query contact data.

Why use AppleScript to query macOS Contacts instead of other automation tools?

Using AppleScript provides ready-to-run examples for listing, searching, and fetching contact details directly from the built-in app. It avoids tedious manual scripting and operates entirely offline.