{"report":{"v":1,"package":"mcp-icloud","version":"2.2.2","ranAt":"2026-11-16T11:38:08.643Z","install":{"ok":true,"integrity":"sha512-vciU345a1Rbf8i0x0BLS4ZHFYaHY6Bxz5dn2WsGk/v48IIisMZ4swJ+yl3HyQBdoHoNvM9iMx8hE2M+02WFzOQ==","deps":47,"scripts":[],"bins":["icloud-mcp"],"license":"MIT","engines":"node >=20","repository":"https://github.com/MrGo2/icloud-mcp.git","bin":"icloud-mcp"},"start":{"ok":true,"ms":203,"serverName":"icloud-mcp","serverVersion":"2.2.2","protocol":"2025-06-18","stderr":"[icloud-mcp] Starting iCloud MCP server v2.2.2...\n[icloud-mcp] Initial mode: CLOUD\n[icloud-mcp] Tools available: 41\n[icloud-mcp] Services: Email, Calendar, Contacts\n[icloud-mcp] Credentials configured: false\n[list-folders] Error: UNAUTHORIZED\n[list-events] Error: UNAUTHORIZED\n[list-calendars] Error: UNAUTHORIZED\n[list-contacts] Error: UNAUTHORIZED\n"},"tools":[{"name":"about","description":"Returns information about this iCloud MCP server","params":[]},{"name":"check-auth-status","description":"Check if iCloud credentials are configured correctly","params":[]},{"name":"set-mode","description":"Switch between LOCAL (AppleScript/macOS apps) and CLOUD (iCloud protocols) modes","params":["mode"]},{"name":"list-emails","description":"Lists emails from a folder (default: inbox)","params":["folder","count"]},{"name":"read-email","description":"Reads the full content of an email by UID","params":["uid","folder"]},{"name":"send-email","description":"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.","params":["to","cc","bcc","subject","body","isHtml"]},{"name":"search-emails","description":"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.","params":["query","from","subject","folder","unreadOnly","count"]},{"name":"mark-as-read","description":"Marks an email as read or unread","params":["uid","folder","isRead"]},{"name":"list-folders","description":"Lists all email folders","params":[]},{"name":"list-events","description":"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.","params":["count","daysAhead"]},{"name":"create-event","description":"Creates a new calendar event","params":["summary","start","end","description","location","calendarUrl","calendarName"]},{"name":"update-event","description":"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.","params":["eventUrl","summary","start","end","description","location"]},{"name":"delete-event","description":"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.","params":["eventUrl"]},{"name":"list-calendars","description":"Lists all available calendars","params":[]},{"name":"list-contacts","description":"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.","params":["count"]},{"name":"search-contacts","description":"Search contacts by name, email, or phone","params":["query","count"]},{"name":"read-contact","description":"Get detailed information about a specific contact","params":["contactUrl"]},{"name":"create-contact","description":"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.","params":["displayName","firstName","lastName","email","phone","organization","title","notes"]},{"name":"delete-contact","description":"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.","params":["contactUrl"]},{"name":"list-contact-accounts","description":"Lists all contact accounts (iCloud, Google, Exchange, etc.) - LOCAL mode only","params":[]},{"name":"list-contact-groups","description":"Lists contact groups from all accounts or a specific account - LOCAL mode only","params":["accountId"]},{"name":"list-reminder-lists","description":"Lists all reminder lists from Reminders.app (LOCAL mode only)","params":[]},{"name":"list-reminders","description":"Lists reminders from a specific list or all lists (LOCAL mode only)","params":["listName","includeCompleted","count"]},{"name":"create-reminder","description":"Creates a new reminder (LOCAL mode only)","params":["name","body","dueDate","listName","priority"]},{"name":"update-reminder","description":"Updates an existing reminder (LOCAL mode only)","params":["reminderId","name","body","dueDate","priority"]},{"name":"complete-reminder","description":"Marks a reminder as complete or incomplete (LOCAL mode only)","params":["reminderId","completed"]},{"name":"delete-reminder","description":"Deletes a reminder (LOCAL mode only)","params":["reminderId"]},{"name":"search-reminders","description":"Search reminders by text in name or body (LOCAL mode only)","params":["query","count"]},{"name":"list-note-folders","description":"Lists all folders in Notes.app (LOCAL mode only)","params":[]},{"name":"list-notes","description":"Lists notes from a specific folder or all folders","params":["folderName","count"]},{"name":"read-note","description":"Reads the content of a specific note","params":["noteId"]},{"name":"create-note","description":"Creates a new note","params":["title","body","folderName"]},{"name":"search-notes","description":"Search notes by text in title or content","params":["query","count"]},{"name":"list-chats","description":"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).","params":["limit","since"]},{"name":"read-messages","description":"Read message history for a specific iMessage/SMS conversation","params":["chatId","limit","start","end","attachments"]},{"name":"send-message","description":"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.","params":["to","body","file"]},{"name":"react-message","description":"Send a tapback reaction (love, like, dislike, laugh, emphasis, question)","params":["chatId","type"]},{"name":"list-safari-tabs","description":"Lists all open tabs in Safari across all windows","params":[]},{"name":"get-current-safari-url","description":"Gets the URL and title of the current/active Safari tab","params":[]},{"name":"open-safari-url","description":"Opens a URL in Safari (new tab or new window)","params":["url","inNewWindow"]},{"name":"close-safari-tab","description":"Closes a Safari tab","params":["windowIndex","tabIndex"]}],"toolsHash":"e1ee4e5b24c4d07a87a2bcb434c7ae3919d3e789884f850d946f9d6603ede476","wrote":[],"callsAt":"2026-11-16T11:38:13.719Z","calls":[{"tool":"about","ok":false,"ms":4,"bytes":237,"error":"replied, but asks for setup: iCloud MCP Server v2.2.2\n\nMode: CLOUD\nServices: Email, Calendar, Contacts\n\nUsing iCloud protocols (IMAP, CalDAV, CardDAV).\n\nCredentials: Not configured (needed for cloud mode)\n\nUse 'set-mode' tool to switch between LOCAL and CLOUD modes."},{"tool":"list-folders","ok":false,"ms":2,"bytes":0,"error":"tool reported an error: [list-folders] Authentication failed. Please verify your iCloud credentials in .env file.\n\nTo set up:\n1. Go to https://appleid.apple.com\n2. Security → App-Specific Passwords → Generate\n3. Copy the pas"},{"tool":"list-events","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: [list-events] Authentication failed. Please verify your iCloud credentials in .env file.\n\nTo set up:\n1. Go to https://appleid.apple.com\n2. Security → App-Specific Passwords → Generate\n3. Copy the pass"},{"tool":"list-calendars","ok":false,"ms":0,"bytes":0,"error":"tool reported an error: [list-calendars] Authentication failed. Please verify your iCloud credentials in .env file.\n\nTo set up:\n1. Go to https://appleid.apple.com\n2. Security → App-Specific Passwords → Generate\n3. Copy the p"},{"tool":"list-contacts","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: [list-contacts] Authentication failed. Please verify your iCloud credentials in .env file.\n\nTo set up:\n1. Go to https://appleid.apple.com\n2. Security → App-Specific Passwords → Generate\n3. Copy the pa"}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":41,"wrote":0,"callsTried":5,"callsAnswered":0,"callContacts":[]},"history":[{"package":"mcp-icloud","version":"2.2.2","ranAt":"2026-11-16T11:38:08.643Z","outcome":"started","tools":41,"contacts":0,"flags":0,"serious":0,"toolsHash":"e1ee4e5b24c4d07a87a2bcb434c7ae3919d3e789884f850d946f9d6603ede476"}],"page":"https://bragproof.smaverk.com/r/mcp-icloud"}