# iCloud Contacts, for your agent

> Let Muse, Claude or ChatGPT look up your iCloud Contacts and, when you allow it, add and update them. One app-specific password, about five minutes to set up.

muse.space wrote this guide, and "we" in it means muse.space. muse.space is an independent project. It is not affiliated with Apple, Meta or any other company whose products it works with.

Your agent finds a number, an address or a birthday when it needs one, and adds or updates a contact once you let it. The app-specific password that opens your mail opens your contacts too.

Start here: [Connect iCloud Contacts](https://muse.space/signup). This guide as a web page: https://muse.space/guides/icloud-contacts

## What your agent can do

Each is a tool your agent calls by name. Read tools are on from the start; write tools wait for your switch.

### Contacts tools

- `contacts.search` (read): **Search contacts.** Search contacts by part of a name, email address, phone number or organization, and return each match’s addresses and numbers.
- `contacts.read` (read): **Read a contact.** Read one contact in full: names, email addresses, phone numbers, postal addresses, organization, birthday, links and notes.
- `contacts.list_address_books` (read): **List address books.** List the address books of this account, with the id other contacts tools take and whether each can be written to.
- `contacts.create` (write): **Create a contact.** Create a contact in an address book from the names, addresses and numbers given.
- `contacts.update` (write): **Change a contact.** Change fields of a contact, keeping every field not named and everything else it holds, such as its photo; it fails if the contact changed since it was read.

## Three steps, about five minutes

### 1. Make an app-specific password

Sign in at [account.apple.com](https://account.apple.com/) and choose **Sign-In and Security**, then **App-Specific Passwords**. Name it `muse.space` and copy the 16 letters Apple shows you.

[Open account.apple.com](https://account.apple.com)

### 2. Add it to muse.space

[Create an account](https://muse.space/signup) and paste the password. Your browser encrypts it before it is sent, and we check it with Apple. The one password opens Mail, Calendar and Contacts.

### 3. Connect your agent

Each agent has a short guide of its own. None of them ever sees the password.

- [Muse](https://muse.space/guides/muse.md): Give Muse your iCloud Mail, Calendar and Contacts without giving it the password. About five minutes from your phone, and free for up to 3 connectors.
- [Claude](https://muse.space/guides/claude.md): Add iCloud Mail, Calendar and Contacts to Claude as a custom connector. Claude signs in, you choose what it may use, and it never sees the password.
- [ChatGPT](https://muse.space/guides/chatgpt.md): Add iCloud Mail, Calendar and Contacts to ChatGPT with developer mode. ChatGPT signs in, you choose what it may use, and it never sees the password.
- [Claude Code](https://muse.space/guides/claude-code.md): One command adds muse.space to Claude Code. Sign in once, and it can search your iCloud Mail, check your calendar and find contacts, without the password.

## Fair things to ask first

### Can my agent delete a contact?

No. No tool deletes a contact. Once you turn writing on, your agent can add contacts and update the ones already there.

### Do you keep my contacts?

No. A contact passes through our servers in memory for the length of the call, and is never saved or logged.

### I already connected iCloud Mail. Do I need another password?

No. Open iCloud Mail in your dashboard: under **Also on this password**, connect iCloud Contacts in one click. It starts read only, like everything else.

### Is this allowed by Apple?

Yes. App-specific passwords are Apple’s supported way for other mail apps to sign in. Ours shows up in your Apple Account like any other, and you can cancel it there at any time without asking us.

### What does it cost?

Nothing for up to 3 connectors, and a password counts once, so iCloud Mail, Calendar and Contacts are one. Personal, for everything more, is $5 a month or $48 a year. It is not on sale yet, and until it is we give it with codes.

## Other guides

- [iCloud Mail](https://muse.space/guides/icloud-mail.md): Let Muse, Claude or ChatGPT search, read and answer your iCloud Mail, attachments included, without ever holding the password. Free for up to 3 connectors.
- [iCloud Calendar](https://muse.space/guides/icloud-calendar.md): Let Muse, Claude or ChatGPT read your iCloud Calendar and, when you allow it, add and move events. One app-specific password, about five minutes to set up.
- [Muse](https://muse.space/guides/muse.md): Give Muse your iCloud Mail, Calendar and Contacts without giving it the password. About five minutes from your phone, and free for up to 3 connectors.
- [Claude](https://muse.space/guides/claude.md): Add iCloud Mail, Calendar and Contacts to Claude as a custom connector. Claude signs in, you choose what it may use, and it never sees the password.
