Return macOS version as a smoke test for the local Apple Ecosystem server.

List calendars across all accounts with uid, account_name, and writable.

List calendar events overlapping an ISO 8601 time range.

Inputs with offsets or trailing Z are converted to local naive datetimes before they are passed to AppleScript.

Get details for a specific event by canonical UID.

Create a calendar event; rejects non-writable calendars.

Inputs with offsets or trailing Z are converted to local naive datetimes before they are passed to AppleScript.

Update an existing event by UID (only provided fields are changed).

clear_location and clear_notes explicitly blank those fields. attendees is accepted as an alias for the older invitees parameter; new attendees are de-duplicated before AppleScript sees them.

Delete an event by UID. Requires confirm=True; otherwise returns a preview.

Find free slots on a given day within working hours of at least duration_minutes.

List today's calendar events.

List tomorrow's calendar events.

List events for the next seven days.

List events for one local date.

Search events by title, location, or notes within a date range.

Create an all-day event for one local date.

Search contacts by name, email, phone, or company.

Get a full contact record by id.

Create a new contact.

Update fields on an existing contact.

Delete a contact by id. Requires confirm=True.

Return contacts with birthdays today.

Return contacts with birthdays in the next N days.

List contact groups.

By default this preserves the legacy list-of-names response. Set include_metadata=True to receive stable group identifiers and discovery metadata.

List files and folders in iCloud Drive.

Read a file from iCloud Drive.

Write a file to iCloud Drive.

Return metadata for a file or folder in iCloud Drive.

Create a folder in iCloud Drive.

Move or rename a file in iCloud Drive.

Delete a file from iCloud Drive (requires confirm=True).

Search iCloud Drive by filename or content.

List all mailboxes across every Mail account with canonical ids.

Search Mail by literal query text or explicit fielded filters. Use this tool for keyword-style lookups such as sender, subject, or body search. For chronological retrieval, prefer mail_recent instead of inventing keywords. If the user asks for mail from a sender and does not give a time window, ask a follow-up for since and/or before rather than running an unbounded sender search. If you already have the window, pass the user's literal query string and constrain it with since and/or before.

Return the most recent Mail messages in chronological order. Use this tool for recency-style requests such as latest, recent, overnight, or today. Do not synthesize topic keywords; instead pass explicit since/before bounds and optional structured filters such as account_name, mailbox_ids, or unread.

Inspect local Apple Mail store availability and access state.

Explain Mail access modes and optionally open Full Disk Access settings.

Create a temporary Mail metadata snapshot for fallback read workflows.

Fetch a Mail message by canonical RFC Message-ID; plain-text body only, 8K cap.

Send a Mail message. Default dry_run=True returns preview without sending.

Create a Mail draft without sending.

Open a Mail message in Mail.app by canonical or store-resolvable id.

Move a Mail message to a mailbox by persistent id.

Flag or unflag a Mail message by canonical id.

Delete a Mail message by canonical id. Requires confirm=True.

List Notes accounts.

List Notes folders, optionally scoped to one account.

List note summaries/previews only. Use notes_read to fetch full note content.

Search note titles and bodies, returning summaries/previews only. Use notes_read with the returned id to fetch full content.

Read one note's full content by stable id or title.

Create a note in a folder.

Append text to a note by stable id or title.

Delete a note by stable id or title. Requires confirm=True.

List reminder lists.

By default this preserves the original list-of-names response. Set include_metadata=True to get stable list identifiers for targeting.

List reminders from a specific list. Always requires list_name or reminders_list_id.

If neither is provided, returns the available reminder lists and asks the user to pick one — never attempts to enumerate all reminders across all lists. limit: max reminders to return (default 20, max 100).

Create a reminder list.

Rename a reminder list by stable id or friendly name.

Delete a reminder list. Requires confirm=True.

Return incomplete reminders due today across all lists.

Return incomplete reminders due before today across all lists.

Search reminders by title or notes across all lists.

Update a reminder by canonical id.

Rename a reminder by canonical id.

Create a reminder.

Mark a reminder as complete.

Delete a reminder. Requires confirm=True.

List discoverable Apple containers across supported scopes.

Return persisted preferences, optionally filtered to a scope.

Set the default target for a scope.

Add an alias for a scope target.

Remove an alias for a scope target.

Resolve a friendly target name against the current inventory and preferences.

List configured scheduled tasks.

Return a single scheduled task by name.

Create and persist a scheduled task.

Run a scheduled task manually.

Enable a scheduled task.

Disable a scheduled task.