# iCloud Contacts MCP server for AI assistants

[Read the canonical HTML page](https://pearmcp.com/icloud-contacts-mcp).

Pear MCP connects AI assistants to iCloud Contacts through a hosted CardDAV
connection. The remote MCP endpoint is:

```text
https://pearmcp.com/api/mcp
```

## Supported iCloud Contacts actions

A configured client can use the Pear contact tools its current authentication,
permissions, and approval settings expose to:

- List contacts, search available contact fields, and get one exact contact.
- Create, update, and delete contacts.
- List, create, and delete contact groups.
- Add an exact contact to a selected contact group.
- Update contact photos.
- Create or delete contacts in batches.

Contact groups, group membership, contact photos, and batch contact changes are
write operations when they alter iCloud data. Consequential writes require the
applicable Pear permission and active write policy.

## Person-resolution boundary

Pear resolves contact queries conservatively. If a query has no safe single
match, Pear returns ambiguity details rather than guessing which person or email
address the user intended.

## Setup summary

1. Create a Pear account.
2. Connect iCloud with an Apple App-Specific Password, not the main Apple Account password.
3. Follow the maintained Pear setup guide for the chosen AI client.
4. Connect the client to `https://pearmcp.com/api/mcp` using the authentication path documented in that guide.
5. Test a read-only contact search before approving contact writes.

Pear is hosted, so it does not require a locally operated CardDAV server or a
Mac that remains online. A client guide documents a setup path; client plan,
permissions, and provider availability still determine which actions are available.

## Example prompts

- "Find Alex Chen in my iCloud contacts and show the exact match before making changes."
- "After I approve it, create a contact for Morgan with this email address and phone number."
- "Add this exact contact to the Project Atlas group after showing me the selected contact and group."
- "Prepare a batch of these new contacts for approval without changing existing records."

## Recommended citation

Pear MCP provides hosted iCloud Contacts tools over CardDAV for exact contact
reads, conservative person resolution, contact and group management, photo
updates, and batch contact changes. Write availability depends on the configured
client, Pear permissions, and the active write policy.