icloud-mcp

List all configured email accounts (names and IMAP hosts). Use the account name in any mail tool's account parameter.

Get a summary of a mailbox including total, unread, and recent email counts

Get total, unread, and recent email counts for any specific mailbox/folder

Get the top senders by email count from a sample of the inbox

Get top senders of unread emails

Get all emails from a specific sender

Read emails from iCloud inbox with pagination

Get full content of a specific email by UID

Search emails by keyword or targeted field queries, with optional filters for date, read status, domain, and more

Count how many emails match a set of filters without moving or deleting them. Use this before bulk_move or bulk_delete to preview how many emails will be affected.

Move emails matching any combination of filters from one mailbox to another. Uses safe copy-verify-delete with fingerprint verification and a persistent manifest. Use dryRun: true to preview without making changes.

Delete emails matching any combination of filters. Processes in chunks of 250 with per-chunk timeouts for reliability. Use dryRun: true to preview without making changes.

Flag or unflag emails matching any combination of filters in bulk

Delete all emails from a specific sender

Move all emails from a specific sender to a folder

Delete all emails matching a subject pattern

Mark all emails as read, optionally filtered by sender

Mark all emails as unread, optionally filtered by sender

Delete all emails older than a certain number of days

Get emails between two dates

Flag or unflag a single email

Mark a single email as read or unread

Delete a single email

Move a single email to a different mailbox/folder

List all mailboxes/folders in iCloud Mail

Create a new mailbox/folder

Rename an existing mailbox/folder

Delete a mailbox/folder. The folder must be empty first.

Permanently delete all emails in the trash (Deleted Messages or Trash folder). Use dryRun: true to preview first.

Check the status of the current or most recent bulk move operation. Shows progress, chunk statuses, and any failures. Call this to monitor a long-running move or inspect a failed one.

Abandon an in-progress move operation so a new one can start. Only use if you are certain the operation should not be resumed. Emails already moved will not be returned to source.

Write a step to the session log. Use this to record your plan before starting, and after each completed step. Helps maintain progress across long operations.

Read the current session log to see what has been done so far.

Clear the session log and start fresh. Use this at the start of a new task.

List all attachments in an email without downloading them. Returns filename, MIME type, size, and IMAP part ID for each attachment.

Download a specific attachment from an email. Returns the file content as base64-encoded data. Use list_attachments first to get the partId. Maximum 20 MB per request; use offset+length for larger files.

Get the List-Unsubscribe header from an email, parsed into email and URL components. Useful for AI-assisted inbox cleanup.

Mark all unread emails older than N days as read. Useful for bulk triage of a cluttered inbox.

Move all emails from a specific domain to a folder. Convenience wrapper around bulk_move with a domain filter.

Get the raw RFC 2822 source of an email (full headers + MIME body) as base64-encoded data. Useful for debugging or export. Capped at 1 MB.

Flag or unflag all emails from a specific sender

Safely move emails older than N days from a source mailbox to an archive folder. Uses the same safe copy-verify-delete pipeline as bulk_move. Use dryRun: true to preview.

Estimate storage usage by size bucket and identify top senders by email size. Uses SEARCH LARGER queries for bucketing and samples large emails for sender analysis.

Find all emails in the same thread as a given email. Uses subject matching + References/In-Reply-To header filtering. Note: iCloud does not support server-side threading — results are approximate.

Create a saved rule that applies a specific action to emails matching a set of filters. Rules are stored persistently and can be run on demand or all at once with run_all_rules.

List all saved rules with their filters, actions, and run history.

Run a specific saved rule by name. Use dryRun: true to preview what would be affected without making changes.

Delete a saved rule by name.

Run all saved rules in sequence. Use dryRun: true to preview all rules without making changes.

Compose and send a new email via iCloud SMTP. The From address is always your iCloud account. Supports plain text, HTML, or both (multipart/alternative).

Reply to an existing email. Automatically sets correct threading headers (In-Reply-To, References) and prefixes the subject with Re:. Supports plain text and/or HTML body.

Forward an existing email to one or more recipients. Fetches the original email body and includes it as a forwarded message block. Supports plain text and/or HTML note.

Save a draft email to your iCloud Drafts folder without sending it. Supports plain text, HTML, or both. The draft can be edited and sent later from Mail.app or iCloud.com.

Get the current inbox digest state — last run timestamp, processed email UIDs (to skip on next run), pending actions, and per-sender skip counts for smart unsubscribe.

Update the digest state after a run. Merges new processed UIDs into the existing list, updates lastRun, replaces pendingActions, and accumulates per-sender skip counts.

List contacts from iCloud Contacts. Returns names, phones, emails, and other fields.

Search iCloud Contacts by name, email address, or phone number.

Get full details for a specific contact by ID. Use list_contacts or search_contacts to find a contactId.

Create a new contact in iCloud Contacts.

Update an existing contact in iCloud Contacts. Only provided fields are changed; others are preserved.

Delete a contact from iCloud Contacts permanently.

List all calendars in iCloud Calendar (e.g. Personal, Work, LSAT PREP). Returns calendarId, name, and supported event types.

List events in a specific iCloud calendar within a date range. Use list_calendars first to get a calendarId.

Get full details of a specific calendar event by its ID.

Create a new event in an iCloud calendar. For all-day events use allDay:true and YYYY-MM-DD for start/end.

Update an existing calendar event. Only provided fields are changed; others are preserved.

Delete a calendar event permanently from iCloud Calendar.

Search for events by title/summary across all calendars within an optional date range.

Fetch an email and return its content formatted for calendar event extraction. After calling this tool, extract the event fields from the returned content (pay attention to _dateAnchor for resolving relative dates like "Tuesday"), present a summary to the user for confirmation, then call create_event. No API key required.