Connectors / ICALApple Calendar (iCloud)

Apple Calendar (iCloud)

Connect your iCloud calendar over CalDAV. Your AI agent lists your calendars, reads events in a date range, finds free slots, and creates new events, all from plain language. It uses an Apple ID and an app-specific password, not your main password, and is revocable any time.

Credentials

All data is protected on the server with AES-256-GCM encryption.

The app password is not your main Apple password. Generate it here: appleid.apple.com → Sign-In and Security → App-Specific Passwords → Generate (two-factor authentication required). You can revoke the password there at any time.
Cancel

Write operations

Decide whether your assistant can only read, or also make changes through this connector.

Enable write tools

Read tools (lists, queries) are always available. When enabled, write tools (create, update, delete) become available too. Transactional calls are logged for 90 days.

Affected write tools (1)
  • create_event: Create a new event in a calendar (requires advanced access).

Available tools (5)

These are the tools your assistant can invoke on this connector, in plain language.

read-only

Query (4)

These tools only read: they fetch data and never change anything.

  • list_calendars

    List the iCloud calendars that support events (name, href, colour).

    claude >List my calendars
  • list_events

    List events from a calendar within a time range.

    claude >What are my events next week?
  • get_event

    Fetch a single event by its href.

    claude >Show the details of tomorrow's 10am event
  • get_free_slots

    Compute free time windows within working hours from busy events.

    claude >When do I have two free hours on Wednesday?
write

Actions (1)

These tools create or modify data. Query tools are always available; write tools can be toggled in the connector settings.

  • create_event

    Create a new event in a calendar (requires advanced access).

    claude >Add a meeting on Friday at 2pm
What is it for?

The Apple Calendar connector talks to the iCloud CalDAV server (caldav.icloud.com) using your Apple ID and an app-specific password. We do not store your main Apple password, only a separate password generated just for this purpose, which you can revoke any time at appleid.apple.com. The connector discovers your calendars (principal and calendar-home discovery), reads events for a given range, computes free slots within your working hours, and creates new events. Writing events is gated by default and only activates when you enable advanced access on the connector.

www.icloud.com/calendar
Apple Calendar (iCloud) interface

Usage

This is how to call this connector through the MCP endpoint.

MCP call example

{
  "connector": "icloud_calendar",
  "action": "...",
  "params": { ... }
}

You can find the MCP endpoint URL on the API keys page.

Documentation

Apple Calendar (iCloud) official docs

Having trouble? Email us at support@connectors.hu.

Installed the connectors CLI? After a connectors refresh the Apple Calendar (iCloud) tools are automatically available in Claude Code.

Install the CLI →