> ## Documentation Index
> Fetch the complete documentation index at: https://pomeroy.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Contacts

> Your AI assistant can look people up in your Apple Contacts. Pomeroy never creates, edits, or deletes a contact, because there is no tool for it.

Contacts is Pomeroy's narrowest app: one tool, which searches. Nothing writes.

<Columns cols={2}>
  <div>
    **Can**

    * Search by name, organisation, email address, or part of a phone number
    * Read back the details of the people it finds
  </div>

  <div>
    **Cannot**

    * Create a contact
    * Edit a contact. Never, not even when asked
    * Delete a contact
  </div>
</Columns>

## Tools

| Tool              | What it does                                                                                                   | Kind |
| ----------------- | -------------------------------------------------------------------------------------------------------------- | ---- |
| `contacts_search` | Searches Contacts by any detail: name, organisation, email address, or phone-number fragment. Case-insensitive | Read |

## Try it

```text theme={null}
What is Priya's mobile number?
What's Sam's home address?
Who do I know at Northwind?
Find the contact with the number ending 4412.
```

## Worth knowing

<AccordionGroup>
  <Accordion title="One tool is the whole surface" icon="lock">
    Your address book is the kind of data where a mistaken edit is hard to
    notice and hard to undo. Pomeroy ships no write tool for it at all, so an
    assistant that decides to "tidy up" a contact simply has no function to
    call.
  </Accordion>

  <Accordion title="Search matches fragments" icon="magnifying-glass">
    A partial phone number or a few letters of an organisation is enough.
    Matching is case-insensitive.
  </Accordion>

  <Accordion title="What a search returns becomes part of the conversation" icon="comment">
    As with every app: the details come back to your assistant, and go wherever
    that conversation goes. Ask about the people you would be happy to paste in.
  </Accordion>
</AccordionGroup>

## Permissions

Switching Contacts on asks macOS for access to your contacts
(`NSContactsUsageDescription`).