All servers / Email / iCloud MCP server
iCloud MCP server
MCP server for Apple services - Email, Calendar, Contacts, Reminders, Notes, Messages and Safari - with dual local (AppleScript) and cloud (IMAP/CalDAV/CardDAV)
Tested by ConnectATDScore 88 out of 100. Tested 2026-11-18 on package version 2.2.2. Package: mcp-icloud · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 18 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 12 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (2.7 seconds including download)
- Tools offered: 41
- Last published: 2026-11-04
- Weekly downloads (npm): 1,997
- License: MIT · Direct dependencies: 8
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
aboutno parametersReturns information about this iCloud MCP server
check-auth-statusno parametersCheck if iCloud credentials are configured correctly
set-mode1 of 1 parameter describedSwitch between LOCAL (AppleScript/macOS apps) and CLOUD (iCloud protocols) modes
list-emails2 of 2 parameters describedLists emails from a folder (default: inbox)
read-email2 of 2 parameters describedReads the full content of an email by UID
send-email6 of 6 parameters describedSends an email immediately from the user's account to one or more comma-separated recipients, with optional CC, BCC and HTML body. Cloud mode delivers over SMTP and returns the new message ID; local mode sends through Mail.app, which only sends plain text and returns no ID. There is no draft step, so the message goes out as soon as the tool runs.
search-emails6 of 6 parameters describedSearches one mail folder (inbox by default) by free text, sender, subject and unread state; the filters combine as AND. Results carry the same summary fields as list-emails, including the ref handle that read-email and mark-as-read take.
mark-as-read3 of 3 parameters describedMarks an email as read or unread
list-foldersno parametersLists all email folders
list-events2 of 2 parameters describedLists upcoming calendar events within a look-ahead window (30 days by default, up to 365). Each event carries its title, start and end times, and the ref handle that update-event and delete-event take as their eventUrl argument.
create-event7 of 7 parameters describedCreates a new calendar event
update-event6 of 6 parameters describedUpdates an existing calendar event. Only the fields you pass are changed. In cloud mode the CalDAV property-merge preserves recurrence, invitees and alarms (experimental: the live round-trip is not yet verified). In local mode, every occurrence of a recurring event shares the series UID, so this acts on the whole series, not one occurrence.
delete-event1 of 1 parameter describedDeletes a calendar event. In local mode, every occurrence of a recurring event shares the series UID, so this acts on the whole series, not one occurrence.
list-calendarsno parametersLists all available calendars
list-contacts1 of 1 parameter describedLists contacts from the user's address book, up to 50 per call, including the handle that read-contact and delete-contact take. For a targeted lookup, search-contacts filters by name, email or phone instead of paging through the full list.
search-contacts2 of 2 parameters describedSearch contacts by name, email, or phone
read-contact1 of 1 parameter describedGet detailed information about a specific contact
create-contact8 of 8 parameters describedCreates a contact in the user's address book (Contacts.app in local mode, iCloud over CardDAV in cloud mode). Every field is optional, so pass at least a name (displayName, or firstName and lastName) along with any known email, phone, organization, job title or notes.
delete-contact1 of 1 parameter describedPermanently deletes a contact from the user's address book. Takes the handle returned by list-contacts or search-contacts; there is no undo through this server.
list-contact-accountsno parametersLists all contact accounts (iCloud, Google, Exchange, etc.) - LOCAL mode only
list-contact-groups1 of 1 parameter describedLists contact groups from all accounts or a specific account - LOCAL mode only
list-reminder-listsno parametersLists all reminder lists from Reminders.app (LOCAL mode only)
list-reminders3 of 3 parameters describedLists reminders from a specific list or all lists (LOCAL mode only)
create-reminder5 of 5 parameters describedCreates a new reminder (LOCAL mode only)
update-reminder5 of 5 parameters describedUpdates an existing reminder (LOCAL mode only)
complete-reminder2 of 2 parameters describedMarks a reminder as complete or incomplete (LOCAL mode only)
delete-reminder1 of 1 parameter describedDeletes a reminder (LOCAL mode only)
search-reminders2 of 2 parameters describedSearch reminders by text in name or body (LOCAL mode only)
list-note-foldersno parametersLists all folders in Notes.app (LOCAL mode only)
list-notes2 of 2 parameters describedLists notes from a specific folder or all folders
read-note1 of 1 parameter describedReads the content of a specific note
create-note3 of 3 parameters describedCreates a new note
search-notes2 of 2 parameters describedSearch notes by text in title or content
list-chats2 of 2 parameters describedList recent iMessage/SMS conversations, most recent first. Use `since` to get only the conversations active after a date (e.g. the last 7 days).
read-messages5 of 5 parameters describedRead message history for a specific iMessage/SMS conversation
send-message3 of 3 parameters describedSends an iMessage or SMS to a phone number or email handle, with an optional file attachment. The message is delivered as soon as the tool runs; there is no draft step and no recall.
react-message2 of 2 parameters describedSend a tapback reaction (love, like, dislike, laugh, emphasis, question)
list-safari-tabsno parametersLists all open tabs in Safari across all windows
get-current-safari-urlno parametersGets the URL and title of the current/active Safari tab
open-safari-url2 of 2 parameters describedOpens a URL in Safari (new tab or new window)
close-safari-tab2 of 2 parameters describedCloses a Safari tab
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.