Read-only: list local Apple Mail account names, sender addresses, and mailbox names. Use this before other Mail tools when the exact names are unknown.

Read-only: list local Apple Mail metadata. Returns message ID, sender, subject, received time, and read/flag status. It does not read message bodies.

Read-only: read one local Apple Mail message, including its body. Use apple_mail_list first to obtain the local mail id.

Send an Apple Mail message from the selected local account. This immediately sends email to the specified recipients.

Modify a local Apple Mail message read/unread and/or flagged status.

Move a local Apple Mail message to another mailbox in the same account.

Delete a local Apple Mail message. This is destructive and moves the message according to Mail.app deletion behavior.

Read-only: list local Calendar.app calendar names and whether each calendar is writable. Use this before creating or modifying events when the exact calendar name is unknown.

Read-only: list local Calendar.app events in a time range.

Create a new local Calendar.app event.

Modify an existing local Calendar.app event. Obtain the uid from apple_calendar_list_events.

Delete an existing local Calendar.app event. This is destructive.

Read-only: list local Apple Reminders list names and IDs. Use this before creating reminders when the exact list name is unknown.

Read-only: list local Apple Reminders.

Create a local Apple Reminder.

Modify an existing local Apple Reminder.

Mark an existing local Apple Reminder as completed.

Delete an existing local Apple Reminder. This is destructive.

Read-only: list Reminders account IDs and names.

Create a Reminders list in an exact account ID.

Rename a Reminders list by ID.

Delete a Reminders list and its reminders. Destructive; may sync to iCloud.

Read-only: get reminder notes, completion, due time, alarm, priority, and flag.

Read-only: search reminder titles within selected lists.

Set a reminder completion state, including reopening a completed reminder.

Set or clear a reminder flag.

Set or clear a reminder notification date.

Create a Calendar.app calendar using the app default account.

Rename a uniquely named writable calendar.

Delete a uniquely named writable calendar and all its events. Destructive.

Read-only: get event notes, recurrence, URL, attendees, and display alarms.

Add a display alarm to an event. Negative minutes means before the event.

Set an event recurrence rule (for example FREQ=WEEKLY;COUNT=5); empty string clears recurrence. Calendar validates the rule.

Set or clear an event HTTP/HTTPS URL.

Read-only: search a mailbox by subject or sender; returns bounded metadata without bodies.

Create a visible outgoing Mail draft. Does not send; Mail controls draft persistence.

Create a mailbox in the selected Mail account.

Read-only: list attachment metadata for one message.

Save one attachment to a new file under APPLE_MCP_FILE_ROOTS. Existing paths are refused.

List open Pages documents. Does not launch a stopped application.

Open a local Pages document. Launches the app and may show its window or import dialogs.

Create an unsaved Pages document. May show a window. Use the returned name for subsequent operations; save explicitly.

Save Pages to a .pages path with an existing parent directory. Existing paths, including the current document path, require overwrite:true. TextEdit saves RTF; no implicit format conversion.

Close one Pages document. Refuses unsaved changes or a document without a saved path unless discardChanges:true; save separately to retain changes.

Export Pages to PDF or its supported Microsoft Office format. Requires an existing parent directory; existing destinations require overwrite:true. Large exports may exceed the automation timeout.

Read Pages plain text with character pagination. Pages supports word-processing body text only; rich formatting and text boxes are not returned.

Replace or append Pages plain text. This can remove existing rich formatting; changes may autosave and sync. Pages requires a word-processing document.

List open Numbers documents. Does not launch a stopped application.

Open a local Numbers document. Launches the app and may show its window or import dialogs.

Create an unsaved Numbers document. May show a window. Use the returned name for subsequent operations; save explicitly.

Save Numbers to a .numbers path with an existing parent directory. Existing paths, including the current document path, require overwrite:true. TextEdit saves RTF; no implicit format conversion.

Close one Numbers document. Refuses unsaved changes or a document without a saved path unless discardChanges:true; save separately to retain changes.

Export Numbers to PDF or its supported Microsoft Office format. Requires an existing parent directory; existing destinations require overwrite:true. Large exports may exceed the automation timeout.

List open Keynote documents. Does not launch a stopped application.

Open a local Keynote document. Launches the app and may show its window or import dialogs.

Create an unsaved Keynote document. May show a window. Use the returned name for subsequent operations; save explicitly.

Save Keynote to a .key path with an existing parent directory. Existing paths, including the current document path, require overwrite:true. TextEdit saves RTF; no implicit format conversion.

Close one Keynote document. Refuses unsaved changes or a document without a saved path unless discardChanges:true; save separately to retain changes.

Export Keynote to PDF or its supported Microsoft Office format. Requires an existing parent directory; existing destinations require overwrite:true. Large exports may exceed the automation timeout.

List open TextEdit documents. Does not launch a stopped application.

Open a local TextEdit document. Launches the app and may show its window or import dialogs.

Create an unsaved TextEdit document. May show a window. Use the returned name for subsequent operations; save explicitly.

Save TextEdit to a .rtf path with an existing parent directory. Existing paths, including the current document path, require overwrite:true. TextEdit saves RTF; no implicit format conversion.

Close one TextEdit document. Refuses unsaved changes or a document without a saved path unless discardChanges:true; save separately to retain changes.

Read TextEdit plain text with character pagination. Pages supports word-processing body text only; rich formatting and text boxes are not returned.

Replace or append TextEdit plain text. This can remove existing rich formatting; changes may autosave and sync. Pages requires a word-processing document.

List sheets in an open Numbers spreadsheet.

List table names and dimensions in a Numbers sheet.

Add a named table without header or footer rows to a Numbers sheet. Rejects duplicate table names.

Read values, formatted text and formulas from a rectangular Numbers range, using 1-based row and column indexes. Maximum 200 cells; strings are truncated to 500 characters per field.

Write a rectangular grid to existing Numbers cells using 1-based indexes. null clears a cell. Formula strings require allowFormulas:true. Bounds are checked before writing; an application failure may leave partial changes. May autosave and sync.

Read slide indexes, default title/body text, presenter notes and skipped status. Does not extract other text boxes, charts, images, or media. Returned text is bounded.

Append a Keynote slide, optionally using an exact master-slide layout name, and set its default title/body, presenter notes and skipped status. Changes may autosave and sync.

Update default title/body, presenter notes or skipped status of a Keynote slide using its current 1-based index. List slides immediately before modifying; changes may autosave and sync.

Read-only: list Notes account IDs and names.

Read-only: list Notes folder IDs and names, optionally within one account.

Read-only: list note metadata without reading note bodies, optionally within a folder.

Read-only: find Notes by title substring; this does not search note bodies.

Read-only: get note metadata and bounded plain text or HTML. Locked notes return metadata only.

Create a note in an explicit folder, with an escaped title heading and optional HTML body. May sync to iCloud.

Change a note title and/or replace its entire HTML body. Replacing the body can remove formatting or attachments; locked notes are rejected.

Delete an unlocked note using Notes deletion behavior. May sync deletion to other devices.

Create a top-level Notes folder in an explicit account.

Read-only: find contacts by name or organization substring. Returns summaries, not all contact details.

Read-only: get one contact with names, organization, emails, phones, and bounded notes.

Read-only: list Contacts groups.

Read-only: list summaries of people in one Contacts group.

Create and save a contact, optionally with labeled emails and phone numbers. Refuses to run while Contacts has unsaved edits.

Update and save selected name, organization, job title, or note fields. Leaves phone and email collections unchanged. Refuses pending unsaved Contacts edits.

Create and save a Contacts group. Refuses pending unsaved Contacts edits.

Add an existing contact to a group and save Contacts changes.

Remove a contact from a group without deleting the contact; saves Contacts changes.

Read-only: list Safari tab titles, URLs, window IDs, and one-based tab indices. Tab indices change when tabs close.

Read-only: read one Safari tab title and URL, with optional bounded page text using Safari scripting. Does not execute page JavaScript.

Open an HTTP(S) URL in a new Safari tab. This loads the URL and can contact a remote website.

Navigate one Safari tab to an HTTP(S) URL. Requires its previously observed URL to avoid modifying a different tab after indices shift.

Close a Safari tab; unsaved page input may be lost. Requires its previously observed URL.

Add an HTTP(S) URL, optional title, and preview to Safari Reading List; may sync through iCloud.

Read-only: list Music playlist persistent IDs, names, and kinds.

Read-only: list Music library or playlist track metadata; IDs are persistent hexadecimal IDs.

Read-only: search an explicit Music playlist. Use list_playlists to identify the library playlist.

Read-only: get one Music library track by persistent ID.

Read-only: get Music playback state, volume, position, and current track when playing or paused.

Control Music playback: play/resume, pause, stop, next, or previous. Play optionally targets one track or playlist. Playback can stream audio.

Set Music playback volume from 0 to 100.

Create a new user playlist in Music. May sync through the music library.

Copy existing library tracks into a regular user playlist. Rejects smart and special playlists. Repeating may add duplicates.

Read-only: list Photos album IDs and names.

Read-only: list Photos library or album media metadata without exporting image data.

Read-only: search Photos using its native search command; returns bounded metadata results.

Read-only: get one Photos media item with metadata, keywords, and bounded description.

Create a new top-level Photos album.

Add existing Photos media items to an album. Does not import or delete files.

Import existing local files into Photos, optionally into an album. Duplicate checking remains enabled; imported media may upload to iCloud Photos.

Export selected Photos media into an existing empty local directory. Requires an empty directory to reduce overwrite risk; originals can trigger iCloud downloads. Exports originals or rendered JPEGs.

Update a Photos media title, description, favorite flag, and/or replace its keyword list. May sync through iCloud Photos.

Read-only: list Messages accounts (also called services), IDs, service types, and connection states. serviceType is null if macOS does not expose it.

Read-only: list Messages chat metadata and participant handles. Apple scripting does not expose message history.

Immediately send text to one explicit phone number or email through a selected connected Messages account. This is a real outgoing message; success means submitted, not delivered.

Read-only: discover installed Apple apps, platform, file roots, and allowed Shortcuts. Does not test Automation permission.

Launch or activate a supported Apple app.

Read-only: list one allowed folder. Bounded, non-recursive; hidden entries excluded by default.

Read-only: file/folder metadata within allowed roots.

Read-only: read bounded UTF-8 text from an allowed regular file. Does not parse Pages, PDF, or other binary formats.

Create a UTF-8 file in an allowed folder. Existing files require overwrite=true.

Create one new folder under an existing allowed folder.

Copy one regular file within allowed roots. Never overwrites a destination.

Read-only: Spotlight filename search within one allowed folder. Results depend on local Spotlight indexing.

Move an allowed file or folder to Finder Trash. Symbolic links are refused to avoid deleting their targets. May sync deletions through iCloud. Never empties Trash.

Reveal an allowed file or folder in Finder.

Read-only: get selected Finder items (names and URLs). Does not read contents.

Read-only: list installed Shortcuts, optionally in one folder.

Read-only: list Shortcuts folders.