apple-productivity-mcp
Local macOS MCP server that automates Apple productivity apps, files, media, and allowlisted Shortcuts from stdio MCP clients (v3.0.0: 133 tools across 17 groups).
Mail: list accounts/mailboxes/messages, read bodies, send email, update read/flag status, move, delete.
Calendar: list calendars/events, create/update/delete events.
Reminders: list lists/reminders, create/update reminders, complete, delete.
Notes/Contacts: list/search/create/update/delete notes, folders, groups, and contacts.
iWork/TextEdit: open/list/read/write/save/export/close Pages, Numbers, Keynote, and TextEdit documents.
Safari/Music/Photos: manage tabs/Reading List, playlists/tracks/playback, and albums/items/import/export/metadata.
Messages/Files/Finder: send messages; bounded file/folder operations; Finder selection, reveal, and Trash.
Shortcuts/System: list and run explicitly allowlisted Shortcuts; discover apps/configuration and launch known Apple apps.
Configuration: enable app groups, read-only mode, restrict file roots, and allowlist Shortcuts.
Safeguards: local stdio only, no hosted service; path checks, overwrite/empty-folder rules, read-only mode, and tool annotations.
Provides tools for interacting with Apple Mail, Calendar, and Reminders on macOS, enabling listing, reading, sending, and managing emails, calendar events, and reminders.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@apple-productivity-mcp list my events for tomorrow"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Apple Productivity MCP
A local macOS MCP server for working with Apple's productivity apps, documents, files, and media from Codex, Claude Code, Claude Desktop, and other stdio MCP clients.
Version 3.0.0: 133 tools across 17 groups, plus optional execution of explicitly allowlisted Shortcuts. Runs on your Mac through Apple's automation interfaces. No hosted service, listening port, subscription, or Apple API key is required.
Tool reference · Machine-readable schemas · Verification · Source documentation · Changelog · Publishing · Directory status
What it can do
App / group | Tools | Coverage |
12 | Accounts and mailboxes; message metadata/body; sender/subject search; visible drafts; send; read/flag status; move/trash; mailbox creation; attachments. | |
Calendar | 12 | Calendars and events; create/update/delete events; event notes, attendees and recurrence; calendar creation/rename/deletion; display alarms and event URLs. |
Reminders | 15 | Accounts/lists; reminders and title search; notes, priorities and due dates; create/update/delete; list management; complete/reopen; flags and notification dates. |
Notes | 9 | Accounts/folders; list/search/read notes; create folders and HTML notes; update and delete unlocked notes. |
Contacts | 9 | Search and contact details; groups and members; create contacts/groups; update fields; add/remove group membership. |
Pages | 8 | List/open/create documents; read/replace/append body text; save; export PDF/DOCX; close with unsaved-change protection. |
Numbers | 11 | Documents, sheets, tables; create tables; read/write bounded cell ranges; save; export PDF/XLSX; close. |
Keynote | 9 | Documents and slides; create presentations; add/update title, body and presenter notes; save; export PDF/PPTX; close. |
TextEdit | 7 | Documents; create/open/read/replace/append text; save RTF; close. |
Safari | 6 | Tabs and page text; open/navigate/close tabs with URL checks; Reading List. |
Music | 9 | Playlists, tracks and search; metadata; create playlists and add tracks; playback and volume. |
Photos | 9 | Albums/items/search; metadata; create albums; add items; import/export; update metadata. |
Messages | 3 | Accounts/chats; send text to an explicit recipient through an explicit account. |
Files | 8 | Bounded folder listing; metadata/text; create text files/folders; copy; Spotlight filename search; Finder Trash. |
Finder | 2 | Selected item metadata; reveal an allowed path. |
Shortcuts | 2 + 1 opt-in | List shortcuts/folders; run only names in the configured allowlist. |
System | 2 | Discover installed apps/configuration; launch a known Apple app. |
The original 18 tool names remain supported. Version 3 expands the default catalog; select only the app groups you want below.
Coverage has boundaries. Apple does not expose every app feature through scripting. Messages history, Contacts deletion, Pages layout text boxes, full document styling, Calendar invitations, Reminders subtasks/tags/recurrence, arbitrary Safari JavaScript, and private Apple databases are not implemented. There are no dedicated Home, Health, Wallet, Find My, or Freeform editing tools. A user-created, allowlisted Shortcut can bridge supported actions in other apps. The complete input schemas describe exactly what each tool accepts.
Related MCP server: Apple Ecosystem MCP
Requirements
macOS and Node.js 20 or newer.
The Apple app you want to control must be installed and configured. Pages, Numbers, and Keynote are separate App Store installations.
A client supporting local stdio MCP servers.
macOS Automation permission for the launching client/process to control each app. Some file locations also require Files & Folders access.
The server starts when the MCP client connects. Each automation call uses a fixed script and JSON arguments with a timeout. iCloud, Exchange, or other account sync continues to follow the app's own settings.
Install
Codex
codex mcp add apple-productivity-local -- \
npx -y @gambadio/apple-productivity-mcp@latest
codex mcp get apple-productivity-localClaude Code
claude mcp add --transport stdio --scope user apple-productivity-local -- \
npx -y @gambadio/apple-productivity-mcp@latest
claude mcp get apple-productivity-localClaude Desktop and other JSON-configured clients
Add this to the client's MCP configuration, then restart it:
{
"mcpServers": {
"apple-productivity-local": {
"command": "npx",
"args": ["-y", "@gambadio/apple-productivity-mcp@latest"]
}
}
}For a reproducible install, replace @latest with @3.0.0. A tested local .mcpb bundle and checksum are available in the GitHub release. See the packaging instructions to build one yourself. This package requires execution on the user's Mac and cannot access their apps from a Linux container or remote hosting service.
Configuration
All settings are optional. Put them in your MCP client's server environment and start a new MCP process.
Variable | Default | Behavior |
| All groups | Comma-separated group names from the table above, lowercase: e.g. |
|
|
|
|
| JSON array of existing absolute directories for Files tools, Finder reveal, Mail attachment saving, and Shortcut file input. Required when using those operations. Paths resolving outside these roots are rejected. |
|
| JSON array of shortcut names/identifiers permitted to run. An empty list omits |
Example with Notes, reminders, files, and one permitted Shortcut:
{
"mcpServers": {
"apple-productivity-local": {
"command": "npx",
"args": ["-y", "@gambadio/apple-productivity-mcp@3.0.0"],
"env": {
"APPLE_MCP_ENABLED_GROUPS": "system,notes,reminders,files,finder,shortcuts",
"APPLE_MCP_FILE_ROOTS": "[\"/Users/YOUR_NAME/Documents\"]",
"APPLE_MCP_SHORTCUTS": "[\"Prepare daily note\"]"
}
}
}
}Replace YOUR_NAME and the shortcut name with values that exist on your Mac. An iCloud Drive directory can be included using its real local absolute path.
File roots constrain the generic file tools listed above; they are not a sandbox for Apple apps. iWork/TextEdit open/save/export and Photos import/export use explicit paths under the macOS permissions of those apps. Shortcuts may perform any action already contained in the allowed shortcut, including sending messages or changing data elsewhere. Inspect a shortcut before allowlisting it. App-group filtering and read-only mode control the exposed tool surface; MCP annotations are hints for clients, not an authorization system.
Example requests
“Find reminders with ‘invoice’ in the title, then show their notes and due dates.”
“Create a Notes folder in this account and put my meeting summary in it.”
“Read this Pages document and export a PDF beside it.”
“List the sheets and tables in my Numbers workbook, then fill cells B2:D6 with these values.”
“Add a Keynote slide with this title, body, and presenter notes.”
“Find Mail messages from this sender and save the selected attachment in my allowed Documents folder.”
“List my Photos albums and export these selected items into an empty folder.”
“Run my allowlisted ‘Prepare daily note’ shortcut.”
Start with discovery tools. Use returned IDs/names and inspect the tool schema for exact fields. apple_system_capabilities identifies installed apps but does not pre-authorize them or prove permissions. Write requests act on real data, so name the intended target and changes explicitly.
Data handling and safeguards
No server-side account, telemetry service, network listener, or credential storage.
Fixed JXA programs receive user values as JSON arguments, without interpolation into executable source. There is no arbitrary code or shell execution tool.
New file copies refuse replacement. Text writes and document save/export require an explicit overwrite option to replace a path. Photos exports require an empty folder.
Generic file operations require explicit roots and check resolved paths. File deletion goes through Finder Trash; there is no empty-Trash tool.
Collection reads and text/cell ranges have limits. Locked Notes are not read or modified. Safari tab mutations compare the expected URL to guard against shifted indices.
Read-only mode hides mutations. Every tool declares read-only, destructive, idempotent, and open-world annotations.
Email, Messages, document changes, reminders, contacts, and media edits may sync or reach other people. A send result means submission to the app, not independently verified delivery.
Timeouts or multi-step errors can leave partial changes. Inspect the target before retrying a write.
Data returned to an MCP client becomes part of that client's active model session and is governed by its data controls. Local execution does not mean content stays outside the model session. JSON inputs are visible to local processes with sufficient OS privileges.
Development and verification
npm ci
npm test
npm run docs:tools
npm audit --omit=dev
npm pack --dry-runTests execute the static automation programs against application fixtures, exercise filesystem boundaries in temporary folders, and initialize the actual stdio MCP server. They do not send messages or edit personal app data.
For the existing read-only Mail/Calendar/Reminders integration suite, after granting Automation permission:
npm run test:integrationLive verification is app-specific. Pages, Numbers, and Keynote were not installed on the release development Mac; their tools have fixture coverage but no live iWork verification. See verification results and limitations and implementation sources. Do not interpret the tool count as a claim that every operation has been exercised against every app/macOS version.
Troubleshooting
Automation unavailable / not authorized / timeout: open System Settings → Privacy & Security → Automation and permit the relevant Apple app for the launching client. A timeout can also reflect a busy app or slow iCloud data; do not blindly retry writes. Restart the client after permission/configuration changes.
Application cannot be found: install the app, launch it once, and verify apple_system_capabilities. OS process sandboxing can also restrict LaunchServices. Run a local client with the appropriate macOS access.
File roots required / path outside allowed roots: configure APPLE_MCP_FILE_ROOTS as a JSON array of existing absolute directories. A symlink cannot be used to escape that list. Create missing parent folders first.
Object not found / ambiguous name: rediscover the app's current account, list, document, or object ID. Names differ by language/provider. Close or rename duplicate documents before editing by name.
Contacts has unsaved changes: save or discard your pending edits in Contacts before using a mutation, because Contacts' scripting save affects all pending changes.
Tools missing: check app-group/read-only settings, start a new session, and verify mcp get/mcp list in your client. Shortcut execution appears only with a nonempty allowlist. Apps need not be installed for their tools to be advertised.
spawn ... ENOENT: ensure Node and npx are accessible to the desktop client's PATH; use the full path returned by command -v npx if needed.
Update or remove
@latest is resolved when a new MCP process starts; restart the client after publishing a release. An existing process continues running its loaded version. To retain the original app scope on v3, set APPLE_MCP_ENABLED_GROUPS=mail,calendar,reminders.
codex mcp remove apple-productivity-local
claude mcp remove apple-productivity-local --scope userRemoving registration does not delete Apple data or clear npm's cache.
Distribution
Canonical source: GitHub. Package: npm. Registry identity: io.github.gambadio/apple-productivity-mcp.
Directory status distinguishes live listings, submissions awaiting review, login requirements, and incompatible or paused destinations. Third-party listing text may lag the source release. Inclusion and recommendation are controlled by those maintainers.
License
MIT. Independent project; not affiliated with or endorsed by Apple.
Available Tools
133 toolsapple_calendar_add_alarmB
Add a display alarm to an event. Negative minutes means before the event.
Inputs: uid (required), minutes (required), calendar (required).
apple_calendar_create_calendarB
Create a Calendar.app calendar using the app default account.
Inputs: name (required), description.
apple_calendar_create_eventC
Create a new local Calendar.app event.
Inputs: end (required), start (required), title (required), calendar (required), +3 more.
apple_calendar_delete_calendarBDestructive
Delete a uniquely named writable calendar and all its events. Destructive.
Inputs: calendar (required).
apple_calendar_delete_eventADestructive
Delete an existing local Calendar.app event. This is destructive.
Inputs: uid (required), calendar (required).
apple_calendar_get_eventBRead-onlyIdempotent
Read-only: get event notes, recurrence, URL, attendees, and display alarms.
Inputs: uid (required), calendar (required).
apple_calendar_list_calendarsARead-onlyIdempotent
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.
Inputs: no named parameters.
apple_calendar_list_eventsBRead-onlyIdempotent
Read-only: list local Calendar.app events in a time range.
Inputs: end (required), start (required), limit, calendars.
apple_calendar_rename_calendarBDestructive
Rename a uniquely named writable calendar.
Inputs: name (required), calendar (required).
apple_calendar_set_recurrenceADestructiveIdempotent
Set an event recurrence rule (for example FREQ=WEEKLY;COUNT=5); empty string clears recurrence. Calendar validates the rule.
Inputs: uid (required), calendar (required), recurrence (required).
apple_calendar_set_urlBDestructiveIdempotent
Set or clear an event HTTP/HTTPS URL.
Inputs: uid (required), url (required), calendar (required).
apple_calendar_update_eventBDestructiveIdempotent
Modify an existing local Calendar.app event. Obtain the uid from apple_calendar_list_events.
Inputs: uid (required), calendar (required), end, notes, +4 more.
apple_contacts_add_to_groupBIdempotent
Add an existing contact to a group and save Contacts changes.
Inputs: groupId (required), contactId (required).
apple_contacts_createB
Create and save a contact, optionally with labeled emails and phone numbers. Refuses to run while Contacts has unsaved edits.
Inputs: firstName (required), note, emails, phones, +3 more.
apple_contacts_create_groupA
Create and save a Contacts group. Refuses pending unsaved Contacts edits.
Inputs: name (required).
apple_contacts_getBRead-onlyIdempotent
Read-only: get one contact with names, organization, emails, phones, and bounded notes.
Inputs: contactId (required), maxChars.
apple_contacts_list_group_membersBRead-onlyIdempotent
Read-only: list summaries of people in one Contacts group.
Inputs: groupId (required), limit, offset.
apple_contacts_list_groupsCRead-onlyIdempotent
Read-only: list Contacts groups.
Inputs: limit, offset.
apple_contacts_remove_from_groupADestructiveIdempotent
Remove a contact from a group without deleting the contact; saves Contacts changes.
Inputs: groupId (required), contactId (required).
apple_contacts_searchARead-onlyIdempotent
Read-only: find contacts by name or organization substring. Returns summaries, not all contact details.
Inputs: query (required), limit, offset.
apple_contacts_updateADestructiveIdempotent
Update and save selected name, organization, job title, or note fields. Leaves phone and email collections unchanged. Refuses pending unsaved Contacts edits.
Inputs: contactId (required), note, jobTitle, lastName, +2 more.
apple_files_copyB
Copy one regular file within allowed roots. Never overwrites a destination.
Inputs: source (required), destination (required).
apple_files_create_folderB
Create one new folder under an existing allowed folder.
Inputs: path (required).
apple_files_infoCRead-onlyIdempotent
Read-only: file/folder metadata within allowed roots.
Inputs: path (required).
apple_files_listARead-onlyIdempotent
Read-only: list one allowed folder. Bounded, non-recursive; hidden entries excluded by default.
Inputs: path (required), limit, includeHidden.
apple_files_read_textARead-onlyIdempotent
Read-only: read bounded UTF-8 text from an allowed regular file. Does not parse Pages, PDF, or other binary formats.
Inputs: path (required), maxBytes.
apple_files_searchARead-onlyIdempotent
Read-only: Spotlight filename search within one allowed folder. Results depend on local Spotlight indexing.
Inputs: path (required), query (required), limit.
apple_files_trashADestructive
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.
Inputs: path (required).
apple_files_write_textADestructive
Create a UTF-8 file in an allowed folder. Existing files require overwrite=true.
Inputs: path (required), text (required), overwrite.
apple_finder_revealC
Reveal an allowed file or folder in Finder.
Inputs: path (required).
apple_finder_selectionARead-onlyIdempotent
Read-only: get selected Finder items (names and URLs). Does not read contents.
Inputs: limit.
apple_keynote_add_slideB
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.
Inputs: documentName (required), body, title, skipped, +2 more.
apple_keynote_closeADestructive
Close one Keynote document. Refuses unsaved changes or a document without a saved path unless discardChanges:true; save separately to retain changes.
Inputs: documentName (required), discardChanges.
apple_keynote_createA
Create an unsaved Keynote document. May show a window. Use the returned name for subsequent operations; save explicitly.
Inputs: themeName.
apple_keynote_exportADestructive
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.
Inputs: path (required), format (required), documentName (required), overwrite.
apple_keynote_list_documentsARead-onlyIdempotent
List open Keynote documents. Does not launch a stopped application.
Inputs: limit, offset.
apple_keynote_list_slidesARead-onlyIdempotent
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.
Inputs: documentName (required), limit, offset.
apple_keynote_openA
Open a local Keynote document. Launches the app and may show its window or import dialogs.
Inputs: path (required).
apple_keynote_saveADestructive
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.
Inputs: path (required), documentName (required), overwrite.
apple_keynote_update_slideADestructive
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.
Inputs: slideIndex (required), documentName (required), body, title, +2 more.
apple_mail_create_draftA
Create a visible outgoing Mail draft. Does not send; Mail controls draft persistence.
Inputs: cc, to, bcc, body, +2 more.
apple_mail_create_mailboxC
Create a mailbox in the selected Mail account.
Inputs: name (required), account.
apple_mail_deleteADestructive
Delete a local Apple Mail message. This is destructive and moves the message according to Mail.app deletion behavior.
Inputs: mailId (required), account, mailbox.
apple_mail_getARead-onlyIdempotent
Read-only: read one local Apple Mail message, including its body. Use apple_mail_list first to obtain the local mail id.
Inputs: mailId (required), account, mailbox.
apple_mail_listARead-onlyIdempotent
Read-only: list local Apple Mail metadata. Returns message ID, sender, subject, received time, and read/flag status. It does not read message bodies.
Inputs: limit, account, mailbox.
apple_mail_list_accountsARead-onlyIdempotent
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.
Inputs: no named parameters.
apple_mail_list_attachmentsBRead-onlyIdempotent
Read-only: list attachment metadata for one message.
Inputs: mailId (required), account, mailbox.
apple_mail_moveADestructive
Move a local Apple Mail message to another mailbox in the same account.
Inputs: mailId (required), targetMailbox (required), account, mailbox.
apple_mail_save_attachmentB
Save one attachment to a new file under APPLE_MCP_FILE_ROOTS. Existing paths are refused.
Inputs: path (required), index (required), mailId (required), account, +1 more.
apple_mail_searchARead-onlyIdempotent
Read-only: search a mailbox by subject or sender; returns bounded metadata without bodies.
Inputs: query (required), field, limit, account, +1 more.
apple_mail_sendB
Send an Apple Mail message from the selected local account. This immediately sends email to the specified recipients.
Inputs: to (required), subject (required), cc, bcc, +2 more.
apple_mail_update_statusADestructiveIdempotent
Modify a local Apple Mail message read/unread and/or flagged status.
Inputs: mailId (required), isRead, account, mailbox, +1 more.
apple_messages_list_accountsBRead-onlyIdempotent
Read-only: list Messages accounts (also called services), IDs, service types, and connection states. serviceType is null if macOS does not expose it.
Inputs: limit, offset.
apple_messages_list_chatsARead-onlyIdempotent
Read-only: list Messages chat metadata and participant handles. Apple scripting does not expose message history.
Inputs: limit, offset, accountId.
apple_messages_sendA
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.
Inputs: text (required), accountId (required), recipient (required).
apple_music_add_tracks_to_playlistA
Copy existing library tracks into a regular user playlist. Rejects smart and special playlists. Repeating may add duplicates.
Inputs: trackIds (required), playlistId (required).
apple_music_create_playlistC
Create a new user playlist in Music. May sync through the music library.
Inputs: name (required).
apple_music_get_playback_stateARead-onlyIdempotent
Read-only: get Music playback state, volume, position, and current track when playing or paused.
Inputs: no named parameters.
apple_music_get_trackBRead-onlyIdempotent
Read-only: get one Music library track by persistent ID.
Inputs: trackId (required).
apple_music_list_playlistsARead-onlyIdempotent
Read-only: list Music playlist persistent IDs, names, and kinds.
Inputs: limit, offset.
apple_music_list_tracksBRead-onlyIdempotent
Read-only: list Music library or playlist track metadata; IDs are persistent hexadecimal IDs.
Inputs: limit, offset, playlistId.
apple_music_playbackA
Control Music playback: play/resume, pause, stop, next, or previous. Play optionally targets one track or playlist. Playback can stream audio.
Inputs: action (required), trackId, playlistId.
apple_music_searchBRead-onlyIdempotent
Read-only: search an explicit Music playlist. Use list_playlists to identify the library playlist.
Inputs: query (required), playlistId (required), only, limit, +1 more.
apple_music_set_volumeBIdempotent
Set Music playback volume from 0 to 100.
Inputs: volume (required).
apple_notes_createA
Create a note in an explicit folder, with an escaped title heading and optional HTML body. May sync to iCloud.
Inputs: title (required), folderId (required), htmlBody.
apple_notes_create_folderA
Create a top-level Notes folder in an explicit account.
Inputs: name (required), accountId (required).
apple_notes_deleteBDestructive
Delete an unlocked note using Notes deletion behavior. May sync deletion to other devices.
Inputs: noteId (required).
apple_notes_getARead-onlyIdempotent
Read-only: get note metadata and bounded plain text or HTML. Locked notes return metadata only.
Inputs: noteId (required), format, maxChars.
apple_notes_listBRead-onlyIdempotent
Read-only: list note metadata without reading note bodies, optionally within a folder.
Inputs: limit, offset, folderId.
apple_notes_list_accountsBRead-onlyIdempotent
Read-only: list Notes account IDs and names.
Inputs: limit, offset.
apple_notes_list_foldersBRead-onlyIdempotent
Read-only: list Notes folder IDs and names, optionally within one account.
Inputs: limit, offset, accountId.
apple_notes_searchBRead-onlyIdempotent
Read-only: find Notes by title substring; this does not search note bodies.
Inputs: query (required), limit, offset, folderId.
apple_notes_updateADestructiveIdempotent
Change a note title and/or replace its entire HTML body. Replacing the body can remove formatting or attachments; locked notes are rejected.
Inputs: noteId (required), title, htmlBody.
apple_numbers_closeADestructive
Close one Numbers document. Refuses unsaved changes or a document without a saved path unless discardChanges:true; save separately to retain changes.
Inputs: documentName (required), discardChanges.
apple_numbers_createA
Create an unsaved Numbers document. May show a window. Use the returned name for subsequent operations; save explicitly.
Inputs: templateName.
apple_numbers_create_tableB
Add a named table without header or footer rows to a Numbers sheet. Rejects duplicate table names.
Inputs: rows (required), columns (required), sheetName (required), tableName (required), +1 more.
apple_numbers_exportADestructive
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.
Inputs: path (required), format (required), documentName (required), overwrite.
apple_numbers_list_documentsBRead-onlyIdempotent
List open Numbers documents. Does not launch a stopped application.
Inputs: limit, offset.
apple_numbers_list_sheetsBRead-onlyIdempotent
List sheets in an open Numbers spreadsheet.
Inputs: documentName (required), limit, offset.
apple_numbers_list_tablesCRead-onlyIdempotent
List table names and dimensions in a Numbers sheet.
Inputs: sheetName (required), documentName (required), limit, offset.
apple_numbers_openB
Open a local Numbers document. Launches the app and may show its window or import dialogs.
Inputs: path (required).
apple_numbers_read_rangeARead-onlyIdempotent
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.
Inputs: rows (required), columns (required), startRow (required), sheetName (required), +3 more.
apple_numbers_saveADestructive
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.
Inputs: path (required), documentName (required), overwrite.
apple_numbers_write_rangeADestructive
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.
Inputs: values (required), startRow (required), sheetName (required), tableName (required), +3 more.
apple_pages_closeADestructive
Close one Pages document. Refuses unsaved changes or a document without a saved path unless discardChanges:true; save separately to retain changes.
Inputs: documentName (required), discardChanges.
apple_pages_createA
Create an unsaved Pages document. May show a window. Use the returned name for subsequent operations; save explicitly.
Inputs: text, templateName.
apple_pages_exportADestructive
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.
Inputs: path (required), format (required), documentName (required), overwrite.
apple_pages_list_documentsBRead-onlyIdempotent
List open Pages documents. Does not launch a stopped application.
Inputs: limit, offset.
apple_pages_openA
Open a local Pages document. Launches the app and may show its window or import dialogs.
Inputs: path (required).
apple_pages_read_textARead-onlyIdempotent
Read Pages plain text with character pagination. Pages supports word-processing body text only; rich formatting and text boxes are not returned.
Inputs: documentName (required), offset, maxChars.
apple_pages_saveADestructive
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.
Inputs: path (required), documentName (required), overwrite.
apple_pages_set_textADestructive
Replace or append Pages plain text. This can remove existing rich formatting; changes may autosave and sync. Pages requires a word-processing document.
Inputs: text (required), documentName (required), mode.
apple_photos_add_to_albumB
Add existing Photos media items to an album. Does not import or delete files.
Inputs: albumId (required), mediaIds (required).
apple_photos_create_albumB
Create a new top-level Photos album.
Inputs: name (required).
apple_photos_exportA
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.
Inputs: mediaIds (required), directory (required), originals.
apple_photos_getBRead-onlyIdempotent
Read-only: get one Photos media item with metadata, keywords, and bounded description.
Inputs: mediaId (required), maxChars.
apple_photos_importA
Import existing local files into Photos, optionally into an album. Duplicate checking remains enabled; imported media may upload to iCloud Photos.
Inputs: paths (required), albumId.
apple_photos_listBRead-onlyIdempotent
Read-only: list Photos library or album media metadata without exporting image data.
Inputs: limit, offset, albumId.
apple_photos_list_albumsBRead-onlyIdempotent
Read-only: list Photos album IDs and names.
Inputs: limit, offset.
apple_photos_searchCRead-onlyIdempotent
Read-only: search Photos using its native search command; returns bounded metadata results.
Inputs: query (required), limit, offset.
apple_photos_updateBDestructiveIdempotent
Update a Photos media title, description, favorite flag, and/or replace its keyword list. May sync through iCloud Photos.
Inputs: mediaId (required), name, favorite, keywords, +1 more.
apple_reminders_completeBDestructiveIdempotent
Mark an existing local Apple Reminder as completed.
Inputs: id (required).
apple_reminders_createC
Create a local Apple Reminder.
Inputs: list (required), title (required), dueAt, notes, +1 more.
apple_reminders_create_listC
Create a Reminders list in an exact account ID.
Inputs: name (required), accountId (required).
apple_reminders_deleteADestructive
Delete an existing local Apple Reminder. This is destructive.
Inputs: id (required).
apple_reminders_delete_listBDestructive
Delete a Reminders list and its reminders. Destructive; may sync to iCloud.
Inputs: id (required).
apple_reminders_getCRead-onlyIdempotent
Read-only: get reminder notes, completion, due time, alarm, priority, and flag.
Inputs: id (required).
apple_reminders_listCRead-onlyIdempotent
Read-only: list local Apple Reminders.
Inputs: limit, lists, includeCompleted.
apple_reminders_list_accountsARead-onlyIdempotent
Read-only: list Reminders account IDs and names.
Inputs: no named parameters.
apple_reminders_list_listsARead-onlyIdempotent
Read-only: list local Apple Reminders list names and IDs. Use this before creating reminders when the exact list name is unknown.
Inputs: no named parameters.
apple_reminders_rename_listBDestructiveIdempotent
Rename a Reminders list by ID.
Inputs: id (required), name (required).
apple_reminders_searchCRead-onlyIdempotent
Read-only: search reminder titles within selected lists.
Inputs: query (required), limit, lists, includeCompleted.
apple_reminders_set_alarmCDestructiveIdempotent
Set or clear a reminder notification date.
Inputs: id (required), remindAt (required).
apple_reminders_set_completedCDestructiveIdempotent
Set a reminder completion state, including reopening a completed reminder.
Inputs: id (required), completed (required).
apple_reminders_set_flaggedCDestructiveIdempotent
Set or clear a reminder flag.
Inputs: id (required), flagged (required).
apple_reminders_updateCDestructiveIdempotent
Modify an existing local Apple Reminder.
Inputs: id (required), dueAt, notes, title, +1 more.
apple_safari_add_reading_listA
Add an HTTP(S) URL, optional title, and preview to Safari Reading List; may sync through iCloud.
Inputs: url (required), title, preview.
apple_safari_close_tabADestructive
Close a Safari tab; unsaved page input may be lost. Requires its previously observed URL.
Inputs: tabIndex (required), windowId (required), expectedUrl (required).
apple_safari_get_tabARead-onlyIdempotent
Read-only: read one Safari tab title and URL, with optional bounded page text using Safari scripting. Does not execute page JavaScript.
Inputs: tabIndex (required), windowId (required), maxChars, includeText.
apple_safari_list_tabsARead-onlyIdempotent
Read-only: list Safari tab titles, URLs, window IDs, and one-based tab indices. Tab indices change when tabs close.
Inputs: limit, offset.
apple_safari_open_tabB
Open an HTTP(S) URL in a new Safari tab. This loads the URL and can contact a remote website.
Inputs: url (required), activate, windowId.
apple_shortcuts_listBRead-onlyIdempotent
Read-only: list installed Shortcuts, optionally in one folder.
Inputs: folder.
apple_shortcuts_list_foldersBRead-onlyIdempotent
Read-only: list Shortcuts folders.
Inputs: no named parameters.
apple_system_capabilitiesARead-onlyIdempotent
Read-only: discover installed Apple apps, platform, file roots, and allowed Shortcuts. Does not test Automation permission.
Inputs: no named parameters.
apple_system_open_appB
Launch or activate a supported Apple app.
Inputs: app (required).
apple_textedit_closeADestructive
Close one TextEdit document. Refuses unsaved changes or a document without a saved path unless discardChanges:true; save separately to retain changes.
Inputs: documentName (required), discardChanges.
apple_textedit_createA
Create an unsaved TextEdit document. May show a window. Use the returned name for subsequent operations; save explicitly.
Inputs: text.
apple_textedit_list_documentsARead-onlyIdempotent
List open TextEdit documents. Does not launch a stopped application.
Inputs: limit, offset.
apple_textedit_openB
Open a local TextEdit document. Launches the app and may show its window or import dialogs.
Inputs: path (required).
apple_textedit_read_textARead-onlyIdempotent
Read TextEdit plain text with character pagination. Pages supports word-processing body text only; rich formatting and text boxes are not returned.
Inputs: documentName (required), offset, maxChars.
apple_textedit_saveADestructive
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.
Inputs: path (required), documentName (required), overwrite.
apple_textedit_set_textADestructive
Replace or append TextEdit plain text. This can remove existing rich formatting; changes may autosave and sync. Pages requires a word-processing document.
Inputs: text (required), documentName (required), mode.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 133 tools
Each tool targets a specific Apple app and action, with app prefixes (e.g., apple_pages_, apple_mail_) clearly separating similar operations like read_text or list across different apps. However, the sheer number of tools (133) and the presence of multiple list/read/search variants for different resources within the same app could cause an agent to momentarily confuse tools without careful reading of descriptions.
All tool names follow a strict snake_case pattern: apple_<app>_<action>. There is no mixing of camelCase or other conventions, and the app prefix consistently disambiguates the domain.
With 133 tools, the server is far beyond the typical 3–15 range and even beyond the 25+ threshold for 'too many'. This extreme count creates significant cognitive overhead and selection risk for an agent, regardless of how well the tools are organized.
The surface covers many Apple apps extensively, but notable gaps exist, such as no delete operation for Contacts (only create/update and group management) and no file move/rename in Files. These missing CRUD/lifecycle operations are significant for a productivity suite and could force agents to work around the server.
Maintenance
Related MCP Connectors
Connect any IMAP/SMTP mailbox to Claude & ChatGPT: search, read, sort, draft. Sends only with OK.
Let your AI agent read and act on your Mail, Calendar, Contacts and more. Works with iCloud.
Connect any mailbox to Claude, ChatGPT & AI: read, send, reply, schedule & search emails.
Mac & Windows: let ChatGPT, Claude & Cursor use your email, calendar, iMessage, Teams, files.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides Claude Desktop with access to Apple Calendar and Reminders on macOS for managing schedules and tasks through natural language. It supports comprehensive operations like creating, editing, and searching events and reminders, along with a custom hashtag-based tagging system.3-
- AlicenseBqualityCmaintenanceEnables Claude to interact with Apple apps on macOS including Mail, Calendar, Contacts, Reminders, Notes, and iCloud Drive for personal productivity tasks like triaging email, managing calendar, and cross-app context.769MIT
- AlicenseBqualityBmaintenanceEnables Claude to interact with Apple services including Email, Calendar, Contacts, Reminders, Notes, Messages, and Safari via AppleScript (macOS) or iCloud protocols.411,584 npm84MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude or any MCP client to read Apple Mail, Calendar, Photos, and create Apple Notes locally on macOS, without any data leaving the machine.MIT