mcp-icloud
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Returns a result when called with no setup: 0 of 5 tools tried
Contacts while installing and starting: nothing
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y mcp-icloud@2.2.2
Installing a package runs its code. Use a sandbox for anything you have not read.
Calling its tools
5 tools that take no input and look read-only were called once with nothing. 0 returned a result.
about | No usable answer replied, but asks for setup: iCloud MCP Server v2.2.2 Mode: CLOUD Services: Email, Calendar, Contacts Using iCloud protocols (IMAP, CalDAV, CardDAV). Credent |
list-folders | No usable answer tool reported an error: [list-folders] Authentication failed. Please verify your iCloud credentials in .env file. To set up: 1. Go to https://appleid.apple.com |
list-events | No usable answer tool reported an error: [list-events] Authentication failed. Please verify your iCloud credentials in .env file. To set up: 1. Go to https://appleid.apple.com |
list-calendars | No usable answer tool reported an error: [list-calendars] Authentication failed. Please verify your iCloud credentials in .env file. To set up: 1. Go to https://appleid.apple.c |
list-contacts | No usable answer tool reported an error: [list-contacts] Authentication failed. Please verify your iCloud credentials in .env file. To set up: 1. Go to https://appleid.apple.co |
During the calls it contacted nothing it had not already contacted.
Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
about
Returns information about this iCloud MCP server
check-auth-status
Check if iCloud credentials are configured correctly
set-mode mode
Switch between LOCAL (AppleScript/macOS apps) and CLOUD (iCloud protocols) modes
list-emails folder, count
Lists emails from a folder (default: inbox)
read-email uid, folder
Reads the full content of an email by UID
36 more tools
send-email to, cc, bcc, subject, body, isHtml
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.
search-emails query, from, subject, folder, unreadOnly, count
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.
mark-as-read uid, folder, isRead
Marks an email as read or unread
list-folders
Lists all email folders
list-events count, daysAhead
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.
create-event summary, start, end, description, location, calendarUrl, calendarName
Creates a new calendar event
update-event eventUrl, summary, start, end, description, location
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). In local mode, every occurrence of a recurring event shares the series UID, so this acts on the whole series, not one occurrence.
delete-event eventUrl
Deletes 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-calendars
Lists all available calendars
list-contacts count
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.
search-contacts query, count
Search contacts by name, email, or phone
read-contact contactUrl
Get detailed information about a specific contact
create-contact displayName, firstName, lastName, email, phone, organization, title, notes
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.
delete-contact contactUrl
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.
list-contact-accounts
Lists all contact accounts (iCloud, Google, Exchange, etc.) - LOCAL mode only
list-contact-groups accountId
Lists contact groups from all accounts or a specific account - LOCAL mode only
list-reminder-lists
Lists all reminder lists from Reminders.app (LOCAL mode only)
list-reminders listName, includeCompleted, count
Lists reminders from a specific list or all lists (LOCAL mode only)
create-reminder name, body, dueDate, listName, priority
Creates a new reminder (LOCAL mode only)
update-reminder reminderId, name, body, dueDate, priority
Updates an existing reminder (LOCAL mode only)
complete-reminder reminderId, completed
Marks a reminder as complete or incomplete (LOCAL mode only)
delete-reminder reminderId
Deletes a reminder (LOCAL mode only)
search-reminders query, count
Search reminders by text in name or body (LOCAL mode only)
list-note-folders
Lists all folders in Notes.app (LOCAL mode only)
list-notes folderName, count
Lists notes from a specific folder or all folders
read-note noteId
Reads the content of a specific note
create-note title, body, folderName
Creates a new note
search-notes query, count
Search notes by text in title or content
list-chats limit, since
List 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-messages chatId, limit, start, end, attachments
Read message history for a specific iMessage/SMS conversation
send-message to, body, file
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.
react-message chatId, type
Send a tapback reaction (love, like, dislike, laugh, emphasis, question)
list-safari-tabs
Lists all open tabs in Safari across all windows
get-current-safari-url
Gets the URL and title of the current/active Safari tab
open-safari-url url, inNewWindow
Opens a URL in Safari (new tab or new window)
close-safari-tab windowIndex, tabIndex
Closes a Safari tab
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | MIT |
|---|---|
| Needs | node >=20 |
| Source | github.com/MrGo2/icloud-mcp |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-vciU345a1Rbf8i0x0BLS4ZHFYaHY6Bxz5dn2WsGk/v48IIisMZ4swJ+yl3HyQBdoHoNvM9iMx8hE2M+02WFzOQ== |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/mcp-icloud)
New version out? Ask for a fresh report.