Check whether Mail.app is running and responding to Automation. Use this before other Mail tools to distinguish "app not running/asleep" from a genuine data error.

Check whether Calendar.app is running and responding to Automation. Use this before other Calendar tools to distinguish "app not running/asleep" from a genuine data error.

List every Mail account configured in Mail.app (iCloud, Google, Exchange, IMAP, etc.) with type, enabled state, and email addresses.

Get details for a single Mail account by name.

Get unread message counts for an account, broken down by mailbox (recursive).

List the full mailbox/folder tree (including nested subfolders and unread counts) for a Mail account.

Create a new mailbox/folder under an account, optionally nested under an existing parent mailbox path.

Rename an existing mailbox/folder. Confirmed via testing to be unreliable via AppleScript/JXA on at least some accounts — expect a PLATFORM_LIMITATION error and rename manually in Mail.app as a fallback.

[IRREVERSIBLE] Permanently delete a mailbox/folder and everything in it. Known to be unreliable for cloud-synced accounts (iCloud/Exchange/IMAP) due to a Mail.app scripting limitation — may fail with PLATFORM_LIMITATION. Requires confirm:true.

Search/list messages in a mailbox with optional filters (read status, flagged status, subject/sender substring). Paginated: default limit 50, max 500.

Get full metadata and plaintext body for a single message.

Get the full raw RFC822 source (headers + MIME body) of a message. Use this to extract HTML bodies or inspect MIME structure.

Get just the raw header block of a message.

List attachments on a message (name, size, download state) without downloading them.

Save one attachment (by its index from mail_list_attachments) to a local directory. Refuses attachments that would need more than a reasonable size — check size via mail_list_attachments first for anything large.

Mark a message as read or unread.

Flag or unflag a message.

Set a message's colored-flag index (-1 clears the flag; 0-6 select a color per Mail.app's flag palette).

Move a message to a different mailbox (recoverable — just relocates it).

Copy a message to a different mailbox, leaving the original in place.

Move a message to Trash. Recoverable — it stays in the account's Trash mailbox until emptied.

[IRREVERSIBLE] Permanently delete a message, bypassing/purging Trash. This cannot be undone. Requires confirm:true.

Create a new draft email (saved to the account's Drafts mailbox). Returns a composeSessionId usable with mail_send_message, mail_update_draft — valid only until Mail.app next restarts.

Create a reply draft to an existing message, with quoted original content prefilled.

Create a forward draft of an existing message.

Update fields (subject/content/recipients) of an open draft compose session by composeSessionId.

List persisted drafts in an account's Drafts mailbox.

Delete a persisted draft from the Drafts mailbox (recoverable via Trash, like mail_delete_message).

[IRREVERSIBLE] Send an email. Either pass composeSessionId to send an existing draft from this Mail.app session, or pass to/subject/content directly to compose and send in one call. Requires confirm:true.

List all Mail signatures (name + content).

Create a new Mail signature.

Update an existing Mail signature's content.

Delete a Mail signature.

List existing Mail rules (name, enabled state). Read-only: creating/editing rules is not achievable via AppleScript/JXA — Mail's rule automation only supports rules invoking a script as an action, not external rule creation. Manage rules in Mail.app > Settings > Rules.

List every calendar across all accounts (iCloud/Google/Exchange/etc.) with its index (use for calendar_* tools when names are ambiguous), writability, and description.

Create a new calendar. Verifies the calendar actually exists after creation before reporting success (Calendar's scripting dictionary has known flaky spots).

Rename an existing calendar.

[IRREVERSIBLE] Permanently delete a calendar and everything in it. Confirmed via testing to be unreliable via scripting on at least some calendars — expect a PLATFORM_LIMITATION error and delete manually in Calendar.app as a fallback. Requires confirm:true.

List events in a calendar within a bounded date range (max 366 days — required, not optional, to avoid multi-year recurrence-expansion queries hanging). Paginated.

Search events in a calendar by summary text within a bounded date range (max 366 days).

Get a single event by its uid (stable iCalendar identifier — see calendar_list_events output).

Create a new event. Verifies the event actually exists (by uid) after creation before reporting success — Calendar's scripting dictionary has known flaky spots for event creation.

Update fields on an existing event by uid. Verifies changed fields actually took effect on re-read before reporting success — recurrence edits on already-recurring events are a known-flaky area.

[IRREVERSIBLE] Delete an event by uid. Confirmed via testing: deleting a RECURRING event silently reports success without actually deleting it on this platform — this tool detects that and returns PLATFORM_LIMITATION instead of a false success; delete recurring events manually in Calendar.app (where you can choose 'this event' vs 'all future events'). Requires confirm:true.

Add a display/sound/email alarm to an event, N minutes before it starts.

List all alarms (display/sound/mail) on an event.

Remove every alarm from an event.

List attendees on an event. Note: once any attendee is added to an event you organize, an extra entry with a null email (the organizer/self) commonly appears — flagged as isLikelyOrganizerSelf, not a bug.

Add an attendee (by email) to an event. This has historically been an unreliable area of Calendar's AppleScript/JXA dictionary — the tool verifies the attendee actually appears on re-read before reporting success.

Remove an attendee (by email) from an event. Unverified/experimental — treat failures as a real platform limitation, not a bug in this tool.

Compute free/busy gaps across one or more calendars within a bounded date range (max 366 days). This is computed locally from calendar_list_events-equivalent data, not a native Calendar.app feature — Calendar's scripting dictionary has no free/busy API.