apple-contacts

Search Apple Contacts for names, phone numbers, emails, and recent entries.

1|Updated May 12, 2026
One-click install
npx skills add https://github.com/estebanrfp/gos --skill apple-contacts-estebanrfp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-contacts
Source: https://github.com/estebanrfp/gos/tree/main/skills/apple-contacts
Command: npx skills add https://github.com/estebanrfp/gos --skill apple-contacts-estebanrfp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of manually searching the macOS Contacts app when you need a person’s phone number, email address, or full contact details.

Core Features & Use Cases

  • Contact Search: Look up people by name, email, or phone number.
  • Recent Contact Listing: Review a small set of recent contacts for quick follow-up.
  • Detailed Record Lookup: Open a matched contact to inspect all available fields.
  • Use Case: A user needs to quickly retrieve a colleague’s mobile number and email before making a call or sending a message.

Quick Start

Use the apple-contacts skill to find Juan’s phone number and email address in 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 search Apple Contacts to find a phone number or email on macOS?

You can search Apple Contacts on macOS by querying the local contacts store to match names, emails, or phone numbers. This skill retrieves full contact records and recent entries directly without opening the Contacts app.

Can I list recent contacts in the macOS Contacts app for quick follow-up?

Yes, you can list recent contacts in the macOS Contacts app. The skill supports a recent contact listing action that reviews a small set of recent entries, allowing you to quickly identify and follow up with people you have interacted with lately.

Does contact search on Mac require shell execution or external dependencies?

No, contact search on Mac does not require shell execution or external dependencies. The skill accesses the local contacts store directly to perform search, list, and get actions safely, without exposing your system to shell command execution.

What's the best way to look up a colleague's full contact details on Mac?

The best way to look up a colleague's full contact details on Mac is to use a detailed record lookup. After finding the contact by name, the skill opens the matched record so you can inspect all available fields, including phone numbers and emails.

Are there limitations when using Apple Contacts search for local contact lookup?

Yes, a limitation of Apple Contacts search is that it requires access to the local contacts store on macOS. It is designed specifically for local contact lookup tasks and does not fetch entries from external cloud directories or third-party address books.