contacts

Search, view, and add contacts in the macOS address book via AppleScript.

32|9|Updated Feb 12, 2026

Search Tags:#search #macos #contacts #lookup #address-book #add-contact

Ready to run

npx skills add https://github.com/DotNetAge/mindx --skill contacts-dotnetage

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: contacts
Source: https://github.com/DotNetAge/mindx/tree/main/skills/contacts
Command: npx skills add https://github.com/DotNetAge/mindx --skill contacts-dotnetage

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq.

What problem does it solve?

这项技能帮助你在本地通讯录中快速搜索、查看和添加联系人，减少手动查找时间并保持联系信息更新。

Core Features & Use Cases

在 macOS 的本地通讯录中搜索并查看联系信息，快速找到目标联系人。
添加新联系人，支持填写姓名、电话和邮箱等字段，便于日后联系。
适用于日常沟通与联系人管理场景，通过简单指令快速完成查找和添加。

Quick Start

直接让系统执行常用操作，如搜索名字为“张三”的联系人，或添加一个新联系人，包含姓名和电话。

Frequently Asked Questions about contacts

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

FAQPage Schema

How do I search contacts in the macOS address book?▼

You can search contacts in the macOS address book by issuing a simple command to look up a specific name. The Skill queries the local Contacts app via AppleScript to quickly retrieve and display the matching contact information.

Can I add a new contact to my local address book from the command line?▼

Yes, you can add a new contact to your local address book by providing details like name, phone number, and email. The Skill parses these parameters using jq and adds the entry directly to the macOS Contacts app.

Does this contact lookup tool work on non-macOS systems?▼

No, this contact lookup tool is designed exclusively for macOS. It relies on the local macOS Contacts app and uses AppleScript for execution, meaning it will not function on Windows or Linux environments.

Do I need to install jq to manage contacts with this Skill?▼

Yes, you need jq installed to manage contacts with this Skill. The tool depends on jq specifically for parsing the input parameters required to search, view, and add contacts in the local address book.

What is the best way to quickly find a contact's phone number for messaging?▼

The best way to find a contact's phone number for messaging is to use the search function to look up the person by name. It directly queries the local address book to streamline contact retrieval and organization.

What limitations exist when adding contacts to the macOS address book?▼

A limitation when adding contacts is that the Skill requires jq for parameter parsing and depends on AppleScript integration. It currently supports adding details like name, phone, and email, but complex field mappings may be restricted.