servers / icloud-mcp
icloud-mcp
communitystdiolocaldestructive capablehealthy
MCP server for iCloud services (Email, Calendar, Contacts)
01Tools · 41
How to read this: tool names here are observed from a live tools/list handshake. The Risk label is a heuristic inferred from the tool name (write/destructive verbs), not from executing the tool — a conservative guess, not a verified capability. We never escalate risk from a description. Found one that's wrong? Tell us — we fix on report.
| Tool | Risk | Side effects | Approval |
|---|---|---|---|
| about Returns information about this iCloud MCP server | read | false | unknown |
| check-auth-status Check if iCloud credentials are configured correctly | read | false | unknown |
| close-safari-tab Closes a Safari tab | unknown | unknown | unknown |
| complete-reminder Marks a reminder as complete or incomplete (LOCAL mode only) | unknown | unknown | unknown |
| create-contact Creates 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. | write | true | unknown |
| create-event Creates a new calendar event | write | true | unknown |
| create-note Creates a new note | write | true | unknown |
| create-reminder Creates a new reminder (LOCAL mode only) | write | true | unknown |
| delete-contact Permanently 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. | destructive | true | true |
| delete-event Deletes a calendar event | destructive | true | true |
| delete-reminder Deletes a reminder (LOCAL mode only) | destructive | true | true |
| get-current-safari-url Gets the URL and title of the current/active Safari tab | read | false | unknown |
| list-calendars Lists all available calendars | read | false | unknown |
| list-chats List recent iMessage/SMS conversations with contact names and last message preview | read | false | unknown |
| list-contact-accounts Lists all contact accounts (iCloud, Google, Exchange, etc.) - LOCAL mode only | read | false | unknown |
| list-contact-groups Lists contact groups from all accounts or a specific account - LOCAL mode only | read | false | unknown |
| list-contacts Lists 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. | read | false | unknown |
| list-emails Lists emails from a folder (default: inbox) | read | false | unknown |
| list-events Lists 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. | read | false | unknown |
| list-folders Lists all email folders | read | false | unknown |
| list-note-folders Lists all folders in Notes.app (LOCAL mode only) | read | false | unknown |
| list-notes Lists notes from a specific folder or all folders | read | false | unknown |
| list-reminder-lists Lists all reminder lists from Reminders.app (LOCAL mode only) | read | false | unknown |
| list-reminders Lists reminders from a specific list or all lists (LOCAL mode only) | read | false | unknown |
| list-safari-tabs Lists all open tabs in Safari across all windows | read | false | unknown |
| mark-as-read Marks an email as read or unread | read | false | unknown |
| open-safari-url Opens a URL in Safari (new tab or new window) | unknown | unknown | unknown |
| react-message Send a tapback reaction (love, like, dislike, laugh, emphasis, question) | unknown | unknown | unknown |
| read-contact Get detailed information about a specific contact | read | false | unknown |
| read-email Reads the full content of an email by UID | read | false | unknown |
| read-messages Read message history for a specific iMessage/SMS conversation | read | false | unknown |
| read-note Reads the content of a specific note | read | false | unknown |
| search-contacts Search contacts by name, email, or phone | read | false | unknown |
| search-emails Searches 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. | read | false | unknown |
| search-notes Search notes by text in title or content | read | false | unknown |
| search-reminders Search reminders by text in name or body (LOCAL mode only) | read | false | unknown |
| send-email Sends 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. | write | true | unknown |
| send-message Sends 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. | write | true | unknown |
| set-mode Switch between LOCAL (AppleScript/macOS apps) and CLOUD (iCloud protocols) modes | write | true | unknown |
| update-event Updates 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). | write | true | unknown |
| update-reminder Updates an existing reminder (LOCAL mode only) | write | true | unknown |
02Install & source
npx -y mcp-icloud
npx- repohttps://github.com/MrGo2/icloud-mcp
- homepagehttps://www.npmjs.com/package/mcp-icloud
- licenseMIT
- adoption48 stars · 18 forks
03Access granted
Update a CRM · writeSchedule a meeting · writeManage docs & notes · writeSend chat messages · writeSend email · write
The access this server can exercise, inferred from its verified tools — not a declared OAuth scope.
05Provenance & freshness
sourcesGitHub repo search [p4]
last_checked2026-09-07 13:09Z
next_check2026-09-07 16:09Z
cadenceevery 3h
verifiedmetadata:passed metadata:passed metadata:passed metadata:passed metadata:passed metadata:passed metadata:passed tools_list:skipped handshake:skipped metadata:passed
index_statusindex — 9 unique facts >= 5
06Badge
Add the “as seen on MCPExplorer” badge to your README. 
[](https://mcpexplorer.com/servers/icloud-mcp)
Next step
This is one server. A loadout combines the right servers, governance, and proven plays for a whole job — assembled deliberately, not tool-dumped.
Explore loadouts →