PlugsightDocs

iCloud Mail

Connect your iCloud Mail (icloud.com, me.com or mac.com) with an app-specific password from your Apple account, in three steps.

Connect your iCloud Mail so your AI can search, read and draft your email, and send when you allow it. Apple requires an app-specific password: a separate password you create in your Apple account only for Plugsight.

What your AI can do

  • Search your mailbox live, with filters such as sender, date, unread and attachments.
  • Read full emails, conversations and attachments (PDF, Word, Excel and PowerPoint are read as text).
  • Save drafts, replies and forwards to your iCloud Drafts.
  • Send email, once you switch sending on and approve each email in the chat.
  • Move emails to folders, flag them and mark them read or unread.

Try asking:

  • "Find the booking confirmation for my trip in March."
  • "Summarise the emails from my accountant this year."
  • "Draft a reply accepting the invitation from James."
  • "Which subscriptions sent me receipts last month?"

See What your AI can do with email for every action in detail.

What you need

  • An iCloud Mail address (@icloud.com, @me.com or @mac.com).
  • Two-factor authentication on your Apple ID. Apple only offers app-specific passwords when it is on.

Connect iCloud Mail

  1. In app.plugsight.app, go to Connections and click Add connection.
  2. Click the iCloud Mail tile. (Or type your iCloud address in the detect box.)
  3. Under Create an app password, click Open iCloud Mail in a new tab ↗. Your Apple account page opens.
  4. Go to Sign-In and Security → App-Specific Passwords, and create a password.
  5. Copy it. Apple shows it once, so copy it before closing that tab.
  6. Back in Plugsight, type your address in Email address and paste the password into App-specific password. Spaces are fine.
  7. Click Test connection & save.

Plugsight signs in to check the password works before saving anything. The server settings (imap.mail.me.com:993 and smtp.mail.me.com:587) are filled in for you.

If you also connect iCloud Calendar or iCloud Contacts, you can create another app-specific password or reuse this one. Your normal Apple password never works here, and stays private.

What it can and can't change

New connections start on Drafts only: your AI can read and write drafts, but can't send. To let it send, click the account's switch on Connections so it says Can send (Pro or Agency plan), and check the line under it says Ready. Every email still needs your yes in the chat.

Labels are a Gmail feature, so on iCloud your AI organises email by moving it to folders instead. Moving and marking emails don't need the switch, but do need a plan that includes changes. See Sending, drafts and the daily email limit.

Limits

  • Your AI can send up to 20 emails per account in any 24 hours by default (you can choose 1 to 500). Drafts don't count.
  • Attachments you send can total up to 20 MB per email.

Troubleshooting

Could not connect: … Check the password; most providers need an app password, not your normal one.

What it means: Apple refused the sign-in. Usually the password is your normal Apple ID password, or the app-specific password was mistyped or revoked.

How to fix it: create a new app-specific password and paste it. Check the address is your iCloud Mail address.

The connection says it needs reconnecting: "The mail server rejected the password; it may have been changed or revoked."

What it means: Apple no longer accepts the app-specific password, for example because you revoked it in your Apple account.

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

This mailbox has no Archive folder. Move it to a folder from list_folders instead (move_to: "").

What it means: your AI tried to archive email, but your mailbox has no folder marked as the archive.

How to fix it: ask your AI to move the emails to a named folder, for example "move them to the Receipts folder".