---
name: contacts
description: Import from the owner's macOS Contacts (read-only against Contacts) — put names on their iMessage/WhatsApp threads, fill the empty fields of existing People notes from the matching card, look a person up ("what's X's number / e-mail?"), or create People notes for the people the owner names. Use when the owner says "import my contacts", "sync my address book", "put names on my texts / WhatsApp", "add X from my contacts", "what's X's phone number / e-mail", "who do I know at <company>", or "fill in my People notes from Contacts". The owner asks in plain language — never make them run a command. Selective by design — it never bulk-creates a note per address-book card unless the owner explicitly asks for everyone. Runs locally on the owner's Mac (needs Full Disk Access), not an automation host. NOT the iMessage or WhatsApp reader (those read messages; this supplies the names), NOT vault-ingestion for pasted content. Requires the contacts module.
---

# contacts — folder-root adapter

The real playbook lives in the brain: **`Agent/skills/contacts.md`** (this folder
is the vault root). Read that file and follow it exactly as written, using the
shipped CLI at `.alexandria/app/.venv/bin/alexandria` wherever it says
`alexandria`, and `.alexandria/app/.venv/bin/python` for
`python -m alexandria_vault.…` entrypoints.

If `Agent/config.json` does not exist, nothing is installed yet — stop and
follow `./CLAUDE.md` (the installer) instead of this skill.
