# iCloud Contacts

> Connect your iPhone and Mac contacts with your Apple ID and an app-specific password, so your AI can look up emails, phones and companies.

Connect iCloud Contacts, the address book on your iPhone and Mac, so your AI can find people's email addresses, phone numbers and companies. Apple has no sign-in button for other apps, so you use your Apple ID and an **app-specific password**.

## What your AI can do

Contacts are read-only: your AI can look people up, but never adds, changes or deletes contacts. Every address book on your iCloud account is included.

- **Search contacts** (`contacts_search`): finds people by name, email, phone number or company. Up to 60 results.
- **List contacts** (`contacts_list`): your contacts in name order, page by page (up to 1,000 at a time).
- **Get a contact** (`contacts_get`): everything saved for one person: emails, phones, organisation, addresses, notes, birthday and links.

Try asking:

- "What's the mobile number for Priya at Northwind?"
- "Who do I know at Acme?"
- "Find the email address of my accountant and draft them a note about this year's receipts." (with an email account in the same MCP server)

## What you need

- Your Apple ID (the one you use on your iPhone or Mac).
- Two-factor authentication on that Apple ID. Apple needs it switched on before you can create an app-specific password.

## Connect iCloud Contacts

It takes about two minutes.

1. In [app.plugsight.app](https://app.plugsight.app), go to **Connections** and click **Add connection**.
2. Click **Contacts**, then the **iCloud Contacts** tile. The **Connect iCloud Contacts** page opens.
3. Click **Open Apple account in a new tab ↗** and sign in at account.apple.com with your Apple ID.
4. Go to **Sign-In and Security** → **App-Specific Passwords** → **Generate an app-specific password**, name it "Plugsight" and click **Create**.
5. Copy the password. It looks like `abcd-efgh-ijkl-mnop`.
6. Back in Plugsight, type your Apple ID in **Apple ID email** and paste the password into **App-specific password**.
7. Optional: type a **Name** for the connection.
8. Click **Test connection & save**. While Plugsight checks, the button says **Checking with Apple…**.

Plugsight signs in to check it works before saving anything. You then see a message such as `Connected you@icloud.com: 1 address book.`

> [!TIP]
> Already connected iCloud Mail or iCloud Calendar? You can make a new app-specific password or reuse that one. Your normal Apple password never works here, and stays private.

## What it can and can't change

Nothing. On **Connections**, the connection shows **Read-only** with no switch.

## Limits

Contacts are kept for up to 5 minutes between searches, so a contact you add or change on your phone can take a few minutes to show up.

## Troubleshooting

### Apple didn't accept that Apple ID and password. Use an app-specific password (account.apple.com → Sign-In and Security → App-Specific Passwords), not your normal password.

**What it means:** Apple refused the sign-in when you connected. Usually it's your normal Apple password, a mistyped app-specific password, or the wrong Apple ID.

**How to fix it:** create a new app-specific password and paste it, and check **Apple ID email** is the Apple ID you use on your iPhone or Mac.

### Apple rejected the Apple ID or app-specific password. Make a new app-specific password and reconnect.

**What it means:** the connection was working, but Apple no longer accepts the password, for example because you revoked it in your Apple account. The connection shows **Reconnect needed**.

**How to fix it:** on **Connections**, click **Reconnect iCloud Contacts**. The connect page opens with your Apple ID filled in. Paste a new app-specific password and click **Test connection & save**.

### No contact with id "…". Use an id from contacts_search.

**What it means:** your AI asked for a contact that no longer exists, for example one you deleted on your phone.

**How to fix it:** ask your AI to search for the person again.

## Related articles

- [iCloud Calendar](https://docs.plugsight.app/connectors/icloud-calendar.md)
- [iCloud Mail](https://docs.plugsight.app/connectors/icloud-mail.md)
- [Google Contacts](https://docs.plugsight.app/connectors/google-contacts.md)
- [Outlook Contacts](https://docs.plugsight.app/connectors/outlook-contacts.md)

---

Web version: https://docs.plugsight.app/connectors/icloud-contacts
