PlugsightDocs

iCloud Calendar

Connect your iPhone and Mac calendar with your Apple ID and an app-specific password, so your AI can find free time and book with approval.

Connect your iCloud calendar, the one on your iPhone and Mac, so your AI can see what's coming up, find free time and, once you allow it, book, move and cancel events. 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

  • See events across all your iCloud calendars, with guests, locations and notes.
  • List repeating events occurrence by occurrence.
  • Find busy times and free gaps of any length, for scheduling.
  • Book, move and cancel events and invite guests, with your approval.

Try asking:

  • "What's on my calendar this week, and where do I have a free afternoon?"
  • "Find a 30-minute slot on Thursday and book a call with sam@example.com."
  • "Move my dentist appointment on Friday to next Monday at the same time."
  • "How many hours of meetings did I have last month?"

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

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 Calendar

It takes about two minutes.

  1. In app.plugsight.app, go to Connections and click Add connection.
  2. Click Calendar, then the iCloud Calendar tile. The Connect iCloud Calendar 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 → +, 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, for example "iCloud Calendar (personal)".
  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: 4 calendars. Every calendar on your iCloud account that holds events is included; you can hide any of them (see below).

Already connected iCloud Mail or iCloud Contacts? 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

The connection starts Read-only: your AI can see events and free time, but can't change anything. To let it book:

  1. On Connections, click the calendar connection's switch so it says Can book & change. This needs the Pro or Agency plan.
  2. Check the line under the switch says Ready.

Every booking, move or cancellation still needs your yes in the chat. See What changes need.

How iCloud handles changes:

  • Repeating events: changing or cancelling affects the whole series, not one occurrence.
  • Guests: by default, guests are invited by email. Your AI can book with guests without emailing them if you ask.
  • Video links: Google Meet links can't be added; your AI can put a video link in the description instead.

Hide a calendar

On Connections, click Show calendars under the connection, then switch off any calendar you don't want your AI to see. Hidden calendars are never read or booked.

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 Calendar. The connect page opens with your Apple ID filled in. Paste a new app-specific password and click Test connection & save.

The event changed in iCloud meanwhile. Fetch it again, then retry.

What it means: the event was edited somewhere else (on your phone, say) while your AI was changing it.

How to fix it: ask your AI to look at the event again, then make the change.

iCloud didn't accept the … (HTTP …). Try again in a minute.

What it means: Apple's server didn't accept the change.

How to fix it: wait a minute and ask again.

For messages about pauses, plans and read-only MCP servers, see Messages your AI may show.