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.
- In app.plugsight.app, go to Connections and click Add connection.
- Click Contacts, then the iCloud Contacts tile. The Connect iCloud Contacts page opens.
- Click Open Apple account in a new tab ↗ and sign in at account.apple.com with your Apple ID.
- Go to Sign-In and Security → App-Specific Passwords → +, name it "Plugsight" and click Create.
- Copy the password. It looks like
abcd-efgh-ijkl-mnop. - Back in Plugsight, type your Apple ID in Apple ID email and paste the password into App-specific password.
- Optional: type a Name for the connection.
- 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.
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.