Apple Tools (Unified)
PYPI · APPLE-TOOLS-MCP · 2 COMPONENTS
Unified Apple ecosystem MCP server for macOS: Mail, Calendar, Notes, Files, Messages, and more.
Available components
Last scanned (20 hours ago)
Scores higher than 99% of PyPI servers
Category Productivity and Notes
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs setuptools.build_meta at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
- 1 of 39 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency100
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to JonathanRReed/Apple-MCPs). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 1 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability85
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 16830 tokens (~82/item across 203 items; 184 tools + 19 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 14 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 186 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 22 Oct 26 +6
- Stability: pass → unverified ▼ security
- Tool safety: pass → unverified ▼ security
- Schema quality: 44 → 82 ▼ functional
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Schema quality: 100 → unverified ▼ functional
- Tool coverage: 1% → 100% ▲ functional
- Schema quality: poor → good functional
- Package version: 1.1.2 → 1.1.3 functional
- 18 Oct 26 0
- Stability: 0.97 → pass security
- 17 Oct 26 +41
- Injection markers: unverified → pass ▲ security
- Stability: unverified → 0.97 ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Schema quality: unverified → 100 ▲ functional
- Package version: 1.0.5 → 1.1.2 functional
- 16 Oct 26 0
- Package version: 1.0.5 → 1.1.2 functional
- 15 Oct 26 0
- Tool safety: Tool safety not yet verified: this server's registry entry declares environment variables (an API key or similar), and its server did not start in our sandbox, so we have no tool text to scan. security
- Stability: Stability not yet verified: this server's registry entry declares environment variables (an API key or similar), and its server did not start in our sandbox, so we have no schema to compare. security
- Tool coverage: Tool coverage not yet verified: this server's registry entry declares environment variables (an API key or similar), and its server did not start in our sandbox, so we have no tool definitions to assess. functional
- Capabilities: Protocol version not yet verified: this server's registry entry declares environment variables (an API key or similar), and its server did not start in our sandbox, so we never saw its MCP handshake. functional
- Schema quality: Schema quality not yet verified: this server's registry entry declares environment variables (an API key or similar), and its server did not start in our sandbox, so we have no schema to assess. functional
- 14 Oct 26 0
- Stability: Stability not yet verified: this server's registry entry declares environment variables (an API key or similar), and its server did not start in our sandbox, so we have no schema to compare. security
- Tool safety: Tool safety not yet verified: this server's registry entry declares environment variables (an API key or similar), and its server did not start in our sandbox, so we have no tool text to scan. security
- Schema quality: Schema quality not yet verified: this server's registry entry declares environment variables (an API key or similar), and its server did not start in our sandbox, so we have no schema to assess. functional
- Capabilities: Protocol version not yet verified: this server's registry entry declares environment variables (an API key or similar), and its server did not start in our sandbox, so we never saw its MCP handshake. functional
- Tool coverage: Tool coverage not yet verified: this server's registry entry declares environment variables (an API key or similar), and its server did not start in our sandbox, so we have no tool definitions to assess. functional
- Package version: 1.0.5 → 1.1.2 functional
- Package version: 1.0.5 → 1.1.1 functional
- 13 Oct 26 0
- Package version: 1.0.5 → 1.1.1 functional
- 12 Oct 26 −41
- Tool safety: pass → unverified ▼ security
- Stability: pass → unverified ▼ security
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Schema quality: 100 → unverified ▼ functional
- Package version: 1.0.5 → 1.1.0 functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 23 Oct 2026 · Analysed pypi/apple-tools-mcp@1.1.3
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | pypi |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | JonathanRReed/Apple-MCPs |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/JonathanRReed/Apple-MCPs/.github/workflows/release.yml@refs/tags/v1.1.3 |
| Rekor log index | 3371477963 |
| Predicate type | PyPI publish attestation https://docs.pypi.org/attestations/publish/v1 |
| Subject digest | sha256:855b038a07c665f7f7d1e5831e19e5244475e154f09059fa9837c11ec58db7c3 |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | allowlisted | setuptools.build_meta |
Background: Why install scripts are a supply-chain risk →
Dependencies 39 packages
| Packages resolved | 39 |
|---|---|
| No linked repository | 1 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
apple_archive_message Apple Archive Message ~113
Move a message to the preferred archive mailbox, or auto-detect an archive mailbox if no preference exists yet.
| Name | Type | Req | Description |
|---|---|---|---|
| archive_account | – | – | Mail account that holds the archive mailbox. Omit to use the saved default archive account. |
| archive_mailbox | – | – | Mailbox to archive into. Omit to use the saved default archive mailbox, or auto-detect one (detected defaults are saved). |
| message_id | string | yes | Mail message_id returned by mail_search_messages, mail_get_message, or mail_get_thread. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_capture_follow_up_from_mail Apple Capture Follow-Up From Mail ~154
Turn an email into a reminder and an archival note using assistant defaults for the destination list and notes folder.
| Name | Type | Req | Description |
|---|---|---|---|
| create_note | boolean | – | Create an archival note with the email content in the default notes folder. |
| create_reminder | boolean | – | Create a follow-up reminder in the default reminder list. |
| due_date | – | – | Optional reminder due date as an ISO 8601 date or datetime. |
| message_id | string | yes | Mail message_id returned by mail_search_messages, mail_get_message, or mail_get_thread. |
| note_title | – | – | Note title. Defaults to 'Mail: <subject or sender>'. |
| reminder_title | – | – | Reminder title. Defaults to 'Follow up: <subject or sender>'. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_control_frontmost_app Apple Control Frontmost App ~424
Use the unified Apple control plane for bounded GUI fallback actions when a native app-domain tool cannot complete the task. Input actions (click_menu_path, press_keys, type_text, click_button, choose_popup_value) require application or bundle_id naming a running app whose bundle id is listed in APPLE_SYSTEM_MCP_GUI_ALLOWED_APPS (comma-separated bundle ids; GUI input is off while it is empty), and that app must come to the front before any input is sent. Terminals, script editors and automation apps are always refused, even if allow-listed.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of list_menu_bar_items, click_menu_path, press_keys, type_text, click_button, choose_popup_value. |
| application | – | – | Running application to target by name, for example TextEdit. Every action except list_menu_bar_items requires application or bundle_id, and the app's bundle id must be listed in APPLE_SYSTEM_MCP_GUI_… |
| bundle_id | – | – | Running application to target by bundle identifier, for example com.apple.TextEdit. Takes precedence over application. Every action except list_menu_bar_items requires application or bundle_id, liste… |
| description | – | – | Accessibility description of the button or pop-up, used when it has no visible label. |
| index | integer | – | Which match to use when several buttons share the label, starting at 1. |
| key | – | – | Printable key or special key name to press. Required for press_keys. |
| label | – | – | Visible label of the button or pop-up. click_button needs label or description. |
| menu_path | – | – | Menu titles from the menu bar down, for example ["File", "New Window"]. Required for click_menu_path. |
| modifiers | – | – | Modifier keys held during press_keys: command, control, option, shift. |
| text | – | – | Text to type. Required for type_text. |
| value | – | – | Pop-up menu value to select. Required for choose_popup_value. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_create_event_interactive Apple Create Event Interactive ~158
Create a Calendar event, asking for missing event details when needed.
| Name | Type | Req | Description |
|---|---|---|---|
| all_day | boolean | – | Set true for an all-day event. |
| calendar_id | – | – | calendar_id from calendar_list_calendars. Omit to use the saved default calendar. |
| end_iso | – | – | Event end as an ISO 8601 datetime with timezone; must be after start_iso. |
| location | – | – | Optional event location. |
| notes | – | – | Optional event notes. |
| start_iso | – | – | Event start as an ISO 8601 datetime with timezone, for example 2026-04-07T15:00:00-05:00. |
| title | – | – | Event title. If missing, clients that support elicitation are asked for it. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_create_note_with_defaults Apple Create Note With Defaults ~121
Create a note using the configured default notes folder when folder_id is omitted.
| Name | Type | Req | Description |
|---|---|---|---|
| body_html | – | – | HTML note body. Takes precedence over body_text. |
| body_text | – | – | Plain-text note body. Ignored when body_html is given. |
| folder_id | – | – | Notes folder_id from notes_list_folders. Omit to use the saved default notes folder. |
| tags | – | – | Optional tags to add to the note, without the leading #. |
| title | string | yes | Note title. Titles containing 'digest' default to the saved digest folder. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_create_reminder_with_defaults Apple Create Reminder With Defaults ~146
Create a reminder using the configured default reminder list when list_id is omitted.
| Name | Type | Req | Description |
|---|---|---|---|
| due_date | – | – | Optional due date as an ISO 8601 date or datetime, for example 2026-04-07 or 2026-04-07T17:00:00-05:00. |
| list_id | – | – | Reminders list_id from reminders_list_lists. Omit to use the saved default reminder list. |
| notes | – | – | Optional notes stored on the reminder. |
| priority | – | – | Apple Reminders priority: 0 none, 1-4 high, 5 medium, 6-9 low. |
| title | string | yes | Reminder title. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_detect_defaults Apple Detect Defaults ~92
Read saved defaults without probing apps. Set probe_apps=true to discover and persist missing Mail, Calendar, Reminders, and Notes targets; this may open apps and request macOS permissions.
| Name | Type | Req | Description |
|---|---|---|---|
| probe_apps | boolean | – | Set true to probe Mail, Calendar, Reminders, and Notes for missing defaults and save what is found; this may open apps and trigger macOS permission prompts. False only reads saved defaults. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_detect_digest_folder Apple Detect Digest Folder ~28
Detect the preferred Notes folder for daily and weekly digests, and persist it if found.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_ensure_digest_folder Apple Ensure Digest Folder ~80
Ensure a dedicated Notes folder exists for daily and weekly digests, creating it when necessary and persisting the preference.
| Name | Type | Req | Description |
|---|---|---|---|
| account_name | – | – | Notes account to create the folder in. Omit to use the existing digest folder's account or the default notes account. |
| folder_name | string | – | Name of the digest folder to find or create. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_event_collaboration_summary Apple Event Collaboration Summary ~48
Summarize attendee state for a shared calendar event so agents can verify collaboration and participation.
| Name | Type | Req | Description |
|---|---|---|---|
| event_id | string | yes | Calendar event_id from calendar_list_events or calendar_get_event. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_find_duplicate_contacts Apple Find Duplicate Contacts ~73
Find likely duplicate contacts through Apple Contacts so assistants can disambiguate people before acting.
| Name | Type | Req | Description |
|---|---|---|---|
| merge_candidates_only | boolean | – | Set true to return only groups that look safe to merge. |
| query | – | – | Optional name, phone, or email to limit the check to matching contacts. Omit to scan all contacts. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_generate_daily_briefing Apple Generate Daily Briefing ~68
Generate a daily Apple briefing from today's context, domain health, and Mail highlights.
| Name | Type | Req | Description |
|---|---|---|---|
| mail_limit | integer | – | Maximum number of Mail highlights to include (1 or more). |
| mail_query | string | – | Apple Mail search text for the highlights section; '*' matches recent messages. |
Structured output declared, but exposes no named fields.
No examples provided.
apple_generate_weekly_briefing Apple Generate Weekly Briefing ~88
Generate a weekly Apple briefing from upcoming events, reminders, and Mail highlights.
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | Number of days ahead to cover, starting now (1 or more). |
| mail_limit | integer | – | Maximum number of Mail highlights to include (1 or more). |
| mail_query | string | – | Apple Mail search text for the highlights section; '*' matches recent messages. |
Structured output declared, but exposes no named fields.
No examples provided.
apple_get_focus_status Apple Get Focus Status ~22
Return truthful Focus support metadata through the unified Apple control plane.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_get_preferences Apple Get Preferences ~21
Read the persisted Apple-Tools assistant defaults and routing preferences.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_get_prompt Apple Get Prompt ~58
Fallback prompt rendering tool for clients that only support tools.
| Name | Type | Req | Description |
|---|---|---|---|
| arguments_json | – | – | Optional prompt arguments as a JSON object string, for example {"topic": "launch"}. |
| name | string | yes | Prompt name from apple_list_prompts. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_get_system_context Apple Get System Context ~29
Return a richer Apple system context snapshot, including Focus, frontmost app, and battery state.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_health Apple Health ~19
Report aggregated health across the unified Apple ecosystem MCP domains.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| domains | object | yes | – |
| ok | boolean | – | – |
| server_name | string | yes | – |
| transport | string | yes | – |
| version | string | yes | – |
No examples provided.
apple_list_prompts Apple List Prompts ~22
Fallback prompt discovery tool for clients that only support tools.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
apple_list_recent_actions Apple List Recent Actions ~44
List recent assistant actions recorded by Apple-Tools for audit and undo workflows.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | – | – | Maximum number of recent actions to return, newest first (1 or more). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_list_shortcuts_for_capability Apple List Shortcuts For Capability ~72
List likely shortcuts for a requested capability so Apple-Tools can use Shortcuts as an intentional bridge when native coverage is missing.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | – | – | Maximum number of shortcut names to return (1 or more). |
| query | string | yes | Capability or shortcut name to match, for example resize image. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_maps_get_directions_strict Apple Maps Get Directions Strict ~71
Get directions through the native Apple Maps MCP and fail closed if the Maps helper is unavailable.
| Name | Type | Req | Description |
|---|---|---|---|
| destination | string | yes | Destination place name or address. |
| origin | string | yes | Starting place name or address. |
| transport | string | – | Travel mode: driving, walking, or transit. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_maps_search_places_strict Apple Maps Search Places Strict ~71
Search places through the native Apple Maps MCP and fail closed if the Maps helper is unavailable.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum number of places to return (1 or more). |
| query | string | yes | Place name, address, or category to search for, for example coffee near Union Square. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_open_application Apple Open Application ~68
Open an application through the unified Apple control plane using its name or bundle identifier.
| Name | Type | Req | Description |
|---|---|---|---|
| application | – | – | Application name as shown in Finder, for example Safari. Provide application or bundle_id. |
| bundle_id | – | – | Application bundle identifier, for example com.apple.Safari. Takes the place of application. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_open_file_path Apple Open File Path ~56
Open a file or folder through Apple Files and return iCloud-aware path metadata.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Absolute path, or a path starting with ~, inside the Apple Files allowed roots (see files_list_allowed_roots). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_overview Apple Overview ~27
Return domain health and saved preferences; defer permission-sensitive data reads and Shortcuts library enumeration.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| ok | boolean | – | – |
| overview | object | yes | – |
No examples provided.
apple_permission_guide Apple Permission Guide ~60
Explain how to grant the Apple permissions needed by a given Apple domain on macOS.
| Name | Type | Req | Description |
|---|---|---|---|
| domain | string | – | Domain to explain: calendar, reminders, messages, contacts, mail, notes, shortcuts, files, system, maps, or all. |
| Name | Type | Req | Description |
|---|---|---|---|
| can_prompt_in_app | boolean | yes | – |
| domain | string | yes | – |
| notes | array | yes | – |
| ok | boolean | – | – |
| requires_manual_system_settings | boolean | yes | – |
| steps | array | yes | – |
No examples provided.
apple_prepare_communication Apple Prepare Communication ~93
Resolve a recipient through Contacts, evaluate available channels, and return the recommended mail or messages target before sending.
| Name | Type | Req | Description |
|---|---|---|---|
| preferred_channel | – | – | Optional channel override: messages, mail, or auto. Omit to use the contact's saved routing, then the assistant default. |
| recipient | string | yes | Who to contact: a contact name (resolved through Contacts and checked for duplicates), a phone number, or an email address. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_prepare_unique_contact Apple Prepare Unique Contact ~56
Resolve a contact for a person-targeted workflow, but stop and return duplicate groups if likely duplicate records need cleanup first.
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | Contact name, phone number, or email address to resolve to exactly one contact. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_preview_archive_message Apple Preview Archive Message ~106
Preview how Apple-Tools will archive a Mail message before moving it.
| Name | Type | Req | Description |
|---|---|---|---|
| archive_account | – | – | Mail account that holds the archive mailbox. Omit to use the saved default archive account. |
| archive_mailbox | – | – | Mailbox to archive into. Omit to use the saved default archive mailbox, or auto-detect one (detected defaults are saved). |
| message_id | string | yes | Mail message_id returned by mail_search_messages, mail_get_message, or mail_get_thread. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_preview_communication Apple Preview Communication ~175
Preview how Apple-Tools will route a communication before sending it through Messages or Mail.
| Name | Type | Req | Description |
|---|---|---|---|
| attachments | – | – | Absolute local file paths to attach. Messages accepts exactly one attachment per send; Mail accepts several. |
| from_account | – | – | Mail account to send from when routed through Mail. Omit to use the saved default Mail account. |
| message | string | yes | Message text, or the email body when the communication routes through Mail. |
| preferred_channel | – | – | Optional channel override: messages, mail, or auto. Omit to use the contact's saved routing, then the assistant default. |
| recipient | string | yes | Who to contact: a contact name (resolved through Contacts and checked for duplicates), a phone number, or an email address. |
| subject | string | – | Email subject; used only when the communication routes through Mail. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_preview_create_note_with_defaults Apple Preview Create Note With Defaults ~123
Preview how Apple-Tools will create a note with the configured default notes folder.
| Name | Type | Req | Description |
|---|---|---|---|
| body_html | – | – | HTML note body. Takes precedence over body_text. |
| body_text | – | – | Plain-text note body. Ignored when body_html is given. |
| folder_id | – | – | Notes folder_id from notes_list_folders. Omit to use the saved default notes folder. |
| tags | – | – | Optional tags to add to the note, without the leading #. |
| title | string | yes | Note title. Titles containing 'digest' default to the saved digest folder. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_preview_create_reminder_with_defaults Apple Preview Create Reminder With Defaults ~148
Preview how Apple-Tools will create a reminder with the configured default reminder list.
| Name | Type | Req | Description |
|---|---|---|---|
| due_date | – | – | Optional due date as an ISO 8601 date or datetime, for example 2026-04-07 or 2026-04-07T17:00:00-05:00. |
| list_id | – | – | Reminders list_id from reminders_list_lists. Omit to use the saved default reminder list. |
| notes | – | – | Optional notes stored on the reminder. |
| priority | – | – | Apple Reminders priority: 0 none, 1-4 high, 5 medium, 6-9 low. |
| title | string | yes | Reminder title. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_preview_follow_up_from_mail Apple Preview Follow-Up From Mail ~152
Preview how Apple-Tools will turn an email into a reminder and note before creating either item.
| Name | Type | Req | Description |
|---|---|---|---|
| create_note | boolean | – | Create an archival note with the email content in the default notes folder. |
| create_reminder | boolean | – | Create a follow-up reminder in the default reminder list. |
| due_date | – | – | Optional reminder due date as an ISO 8601 date or datetime. |
| message_id | string | yes | Mail message_id returned by mail_search_messages, mail_get_message, or mail_get_thread. |
| note_title | – | – | Note title. Defaults to 'Mail: <subject or sender>'. |
| reminder_title | – | – | Reminder title. Defaults to 'Follow up: <subject or sender>'. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_recheck_permissions Apple Recheck Permissions ~32
Recheck Apple domain health after the user changes macOS permissions, and notify the client that Apple resources changed.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| domains | object | yes | – |
| ok | boolean | – | – |
| server_name | string | yes | – |
| transport | string | yes | – |
| version | string | yes | – |
No examples provided.
apple_reveal_in_finder Apple Reveal In Finder ~53
Reveal a file or folder in Finder through Apple Files.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Absolute path, or a path starting with ~, inside the Apple Files allowed roots (see files_list_allowed_roots). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_route_or_run_shortcut Apple Route Or Run Shortcut ~141
Use Apple Shortcuts as the explicit bridge when native Apple MCP coverage is insufficient or when the user names a shortcut directly.
| Name | Type | Req | Description |
|---|---|---|---|
| dry_run | boolean | – | Set true to report which shortcut would run without running it. |
| input_paths | – | – | Optional absolute file paths passed to the shortcut as input. |
| input_text | – | – | Optional text passed to the shortcut as input. |
| request | string | yes | What the user wants done. Used to pick a single matching shortcut when shortcut_name_or_identifier is omitted. |
| shortcut_name_or_identifier | – | – | Exact shortcut name or identifier to run. Omit to route from request; ambiguous requests fail without running anything. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_send_communication Apple Send Communication ~172
Send a communication through Messages or Mail using Contacts resolution and assistant defaults.
| Name | Type | Req | Description |
|---|---|---|---|
| attachments | – | – | Absolute local file paths to attach. Messages accepts exactly one attachment per send; Mail accepts several. |
| from_account | – | – | Mail account to send from when routed through Mail. Omit to use the saved default Mail account. |
| message | string | yes | Message text, or the email body when the communication routes through Mail. |
| preferred_channel | – | – | Optional channel override: messages, mail, or auto. Omit to use the contact's saved routing, then the assistant default. |
| recipient | string | yes | Who to contact: a contact name (resolved through Contacts and checked for duplicates), a phone number, or an email address. |
| subject | string | – | Email subject; used only when the communication routes through Mail. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_send_message_interactive Apple Send Message Interactive ~73
Send an Apple Messages message, asking for missing recipient or text when needed.
| Name | Type | Req | Description |
|---|---|---|---|
| recipient | – | – | Contact name, phone number, or email address. If missing, clients that support elicitation are asked for it. |
| text | – | – | Message text. If missing, clients that support elicitation are asked for it. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_set_digest_folder Apple Set Digest Folder ~85
Persist the dedicated Notes folder that Apple-Tools should use for daily and weekly digests.
| Name | Type | Req | Description |
|---|---|---|---|
| account_name | – | – | Notes account that holds the folder, for example iCloud. |
| folder_id | string | yes | Notes folder_id from notes_list_folders to use for digests. |
| folder_name | – | – | Display name of the folder. Defaults to folder_id in the response. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
apple_suggest_calendars Apple Suggest Calendars ~70
Apple Suggest Calendars using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | – | – | Maximum number of suggestions to return (1 or more). |
| query | – | – | Optional text to filter suggestions by. Omit to list the first available values. |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | – |
| domain | string | yes | – |
| ok | boolean | – | – |
| suggestions | array | yes | – |
No examples provided.
apple_suggest_contacts Apple Suggest Contacts ~67
Apple Suggest Contacts using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | – | – | Maximum number of suggestions to return (1 or more). |
| query | – | – | Optional text to filter suggestions by. Omit to list the first available values. |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | – |
| domain | string | yes | – |
| ok | boolean | – | – |
| suggestions | array | yes | – |
No examples provided.
apple_suggest_files Apple Suggest Files ~67
Apple Suggest Files using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | – | – | Maximum number of suggestions to return (1 or more). |
| query | – | – | Optional text to filter suggestions by. Omit to list the first available values. |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | – |
| domain | string | yes | – |
| ok | boolean | – | – |
| suggestions | array | yes | – |
No examples provided.
apple_suggest_mailboxes Apple Suggest Mailboxes ~69
Apple Suggest Mailboxes using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | – | – | Maximum number of suggestions to return (1 or more). |
| query | – | – | Optional text to filter suggestions by. Omit to list the first available values. |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | – |
| domain | string | yes | – |
| ok | boolean | – | – |
| suggestions | array | yes | – |
No examples provided.
apple_suggest_message_conversations Apple Suggest Message Conversations ~70
Apple Suggest Message Conversations using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | – | – | Maximum number of suggestions to return (1 or more). |
| query | – | – | Optional text to filter suggestions by. Omit to list the first available values. |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | – |
| domain | string | yes | – |
| ok | boolean | – | – |
| suggestions | array | yes | – |
No examples provided.
apple_suggest_note_folders Apple Suggest Note Folders ~71
Apple Suggest Note Folders using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | – | – | Maximum number of suggestions to return (1 or more). |
| query | – | – | Optional text to filter suggestions by. Omit to list the first available values. |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | – |
| domain | string | yes | – |
| ok | boolean | – | – |
| suggestions | array | yes | – |
No examples provided.
apple_suggest_places Apple Suggest Places ~67
Apple Suggest Places using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | – | – | Maximum number of suggestions to return (1 or more). |
| query | – | – | Place text to search Apple Maps for. Without a query no suggestions are returned. |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | – |
| domain | string | yes | – |
| ok | boolean | – | – |
| suggestions | array | yes | – |
No examples provided.
apple_suggest_reminder_lists Apple Suggest Reminder Lists ~70
Apple Suggest Reminder Lists using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | – | – | Maximum number of suggestions to return (1 or more). |
| query | – | – | Optional text to filter suggestions by. Omit to list the first available values. |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | – |
| domain | string | yes | – |
| ok | boolean | – | – |
| suggestions | array | yes | – |
No examples provided.
apple_suggest_running_apps Apple Suggest Running Apps ~69
Apple Suggest Running Apps using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | – | – | Maximum number of suggestions to return (1 or more). |
| query | – | – | Optional text to filter suggestions by. Omit to list the first available values. |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | – |
| domain | string | yes | – |
| ok | boolean | – | – |
| suggestions | array | yes | – |
No examples provided.
apple_suggest_shortcuts Apple Suggest Shortcuts ~69
Apple Suggest Shortcuts using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | – | – | Maximum number of suggestions to return (1 or more). |
| query | – | – | Optional text to filter suggestions by. Omit to list the first available values. |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | – |
| domain | string | yes | – |
| ok | boolean | – | – |
| suggestions | array | yes | – |
No examples provided.
How do I install the Apple Tools (Unified) MCP server?
Apple Tools (Unified) runs locally as a PyPI package, launched with uvx apple-tools-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · apple-tools-mcp
claude mcp add jonathanrreed-apple-tools-mcp -- uvx apple-tools-mcp
What is the Apple Tools (Unified) MCP server?
Apple Tools (Unified) is an MCP server listed in the public MCP registry as io.github.JonathanRReed/apple-tools-mcp. Unified Apple ecosystem MCP server for macOS: Mail, Calendar, Notes, Files, Messages, and more. This page covers its PyPI package (apple-tools-mcp).
Is the Apple Tools (Unified) MCP server safe to use?
Apple Tools (Unified) scores 97 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 23 October 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Apple Tools (Unified) MCP server expose?
Apple Tools (Unified) exposes 184 tools: apple_get_preferences, apple_detect_defaults, apple_update_preferences, apple_detect_digest_folder, apple_set_digest_folder, and 179 more. Their descriptions and schemas cost roughly 16,164 tokens of context every time the server is loaded.
Is the Apple Tools (Unified) MCP server still maintained?
Apple Tools (Unified) is still listed as active in the MCP registry. We last reached this channel on 23 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the Apple Tools (Unified) MCP server under?
Apple Tools (Unified) declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.