# iCloud Mail, for your agent > 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. 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 searches and reads your mail, attachments included: PDFs, Office files and pictures. Once you turn writing on, it drafts, replies, files and sends. You store an app-specific password here once, and your agent never sees it. Start here: [Connect iCloud Mail](https://muse.space/signup). This guide as a web page: https://muse.space/guides/icloud-mail ## 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. ### Mail tools - `mail.search` (read): **Search mail.** Search one folder by sender, recipient, subject, text, date or flags, newest first, without bodies; while code and link hiding is on, terms with digits or URL punctuation miss very recent mail. - `mail.read` (read): **Read a message.** Read one message as headers, plain body text and attachment details, with one-time codes and reset links removed. - `mail.read_attachment` (read): **Read an attachment.** Read one attachment of a message: the text of a PDF, Office or text file, or a picture as an image, with one-time codes and reset links removed. - `mail.list_folders` (read): **List folders.** List the folders of the mailbox with their role, message count and unread count. - `mail.draft` (write): **Save a draft.** Save a draft in the Drafts folder for a person to review, without sending anything. - `mail.reply` (write): **Reply to a message.** Send a reply to a message now, in the same thread, to its sender or to everyone on it. - `mail.send` (write): **Send a message.** Send a new plain text message from the mailbox now, within its daily send limit and recipient rules. - `mail.move_flag` (write): **Move or flag messages.** Move up to 50 messages to another folder, or mark them read, unread, flagged or unflagged, with at least one change given. - `mail.archive` (write): **Archive messages.** Move up to 50 messages out of their folder into the Archive of this mailbox, or into All Mail on Gmail; nothing is erased. - `mail.delete` (write): **Delete messages.** Move up to 50 messages to the Trash folder of this mailbox, from which a person can restore them; nothing is erased. ## 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. ## Limits you can set - Sending is off until you turn it on. Then we cap it at 50 messages a day, or whatever number you choose. - Say who your agent may write to, by address or by whole domain. - Your agent sends from your iCloud address, or another address the mailbox has, such as one on your own domain. - New mail is checked every 5 minutes, and waits as a short notice until your agent asks for it. You can turn that off. ## Fair things to ask first ### 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. ### Do you keep my mail? No. A message passes through our servers in memory for the length of the call, and is never saved or logged. The one thing kept is a short notice that new mail arrived, until your agent has it: the [security page](https://muse.space/security) lists exactly what it holds. ### Which attachments can my agent read? PDFs and Word, Excel and PowerPoint files up to 10 MB, and pictures up to 5 MB. A scanned PDF has no text in it, so your agent is told that rather than left to guess, and a file with a password stays closed. ### Which addresses does it work with? You sign in with your iCloud Mail address, one that ends in `@icloud.com`, `@me.com` or `@mac.com`. Mail sent to an address on your own domain through iCloud+ is in the same mailbox, and your agent can send from that address too once you add it. ### 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 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. - [iCloud Contacts](https://muse.space/guides/icloud-contacts.md): 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](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.