Apple Tools (Unified)

io.github.JonathanRReedPublished by GitHub account JonathanRReedv1.1.6Updated Nov 7, 2026

Unified Apple ecosystem MCP server for macOS: Mail, Calendar, Notes, Files, Messages, and more.

The publisher's own server: Core

Overview

AI-generated overview

Unified macOS MCP server giving an assistant one entrypoint to Mail, Calendar, Reminders, Messages, Contacts, Notes, Shortcuts, Files, System and Maps.

What you can do
  • Read and act across Apple apps: mail search, threads, drafts and archiving; calendar events; reminders and notes with saved defaults
  • Resolve people through Contacts, then prepare, preview and send messages or mail, with per-contact routing preferences
  • Work with local files and Finder: open paths, reveal items, edit Finder tags, and attach documents within allowed roots
  • Inspect system context such as frontmost app, clipboard, battery and Focus, open apps, change macOS settings, and run bounded GUI fallback input
  • Search places and get directions through Apple Maps, and run Shortcuts as a bridge when native coverage is missing
  • Preview, audit and undo recent actions, plus daily and weekly…
When to use it
Useful when you want personal-assistant workflows that span several Apple apps on one Mac, such as turning an email into a reminder and note, planning a day across Calendar and Reminders, or routing a message to the right person. It also suits users who prefer one install over wiring up ten separate Apple MCP servers.
Requirements
Runs locally on macOS only, via uvx from PyPI or a Claude Desktop bundle; Python 3.11+ for the clone/start script path. macOS permissions are needed per domain: Automation for Mail, Messages and Notes, plus Calendar, Reminders and Contacts access, and Full Disk Access for Messages history. Maps needs a local Swift helper and Xcode command line tools. Behaviour is tuned with environment variables such as the per-domain safety modes, APPLE_FILES_MCP_ALLOWED_ROOTS…
Before you install
It can send messages and mail, create and edit calendar events, reminders, notes and contacts, archive mail, change macOS settings and send GUI input, so set each domain's safety mode deliberately; the Claude Desktop bundle defaults Mail to full_access, which lets the assistant send email itself. GUI input is off until apps are listed in APPLE_SYSTEM_MCP_GUI_ALLOWED_APPS, and terminals and script editors are always refused. File access is limited to APPLE_FILES_MCP_ALLOWED_ROOTS. Preferences…

Installation

In SourceWeft

  1. Open Apple Tools (Unified) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Apple-Tools-MCP

Unified MCP server for Apple apps on macOS.

One entrypoint for Mail, Calendar, Reminders, Messages, Contacts, Notes, Shortcuts, Files, System, and Maps. This server wraps the standalone servers and exposes a unified MCP interface.

What It Does

  • Read context across multiple Apple apps
  • Unified actions across all apps
  • Prompts for day planning, communications triage, and meeting prep
  • Persistent defaults for mail, calendar, reminders, notes, and communication routing
  • Per-contact preferences for people who always route a specific way
  • Helper workflows for communication routing, archiving mail, capturing follow-ups, and collaboration summaries
  • Mail thread helpers and Contacts method editing in one place
  • Preview, audit, and undo for reversible actions
  • Files-aware attachment and document workflows within scoped roots
  • System-aware workflows using the frontmost app, clipboard, notifications, running apps, and assistant-relevant macOS settings
  • Truthful Focus context and combined system snapshots for briefing and routing
  • Explicit macOS settings writes for appearance, Finder, Dock, and key accessibility preferences
  • Bounded GUI fallback tools when a native app-domain MCP cannot complete a task directly
  • Finder-aware file workflows, Finder tags, recent locations, and iCloud Drive awareness through Apple Files
  • Travel-aware workflows using Apple Maps for place search and route estimates
  • Daily briefing, weekly briefing, and communications-triage tools
  • Prompt fallback via apple_list_prompts and apple_get_prompt
  • One install target instead of ten separate configurations

When to use

  • Personal assistant workflows across multiple Apple apps
  • Cross-app operations (e.g., Calendar and Reminders together)
  • Simpler setup without wiring each standalone MCP separately

Tool Discovery

Apple-Tools-MCP exposes its full tool surface through tools/list, with readOnlyHint/destructiveHint annotations and structured output schemas — modern clients defer-load large tool surfaces themselves. For context-constrained clients:

  • search_tools finds tools by name, aliases, and domain tags
  • get_tool_info loads the full schema and examples for one tool on demand
  • generated code-mode wrappers are exported under generated/tool_wrappers/python

Install On This Mac

Quick start (uvx, from PyPI)

With uv installed:

bash
uvx apple-tools-mcp

No clone, no venv management.

From a clone
bash
git clone https://github.com/JonathanRReed/Apple-MCPs.gitcd Apple-MCPsuv sync --all-packages

This builds one uv workspace environment with the unified entrypoint at .venv/bin/apple-tools-mcp plus every standalone server's console script (bash scripts/install_all.sh does the same, with a venv fallback for machines without uv). You can also point an MCP client at Apple-Tools-MCP/start.sh, which prefers uv run and falls back to a plain venv bootstrap (Python 3.11+ required).

Install In AI Agents

Generic MCP client config
json
{  "mcpServers": {    "apple-tools": {      "command": "uvx",      "args": ["apple-tools-mcp"],      "env": {        "APPLE_MAIL_MCP_SAFETY_PROFILE": "safe_manage",        "APPLE_CALENDAR_MCP_SAFETY_MODE": "safe_manage",        "APPLE_REMINDERS_MCP_SAFETY_MODE": "safe_manage",        "APPLE_FILES_MCP_ALLOWED_ROOTS": "/Users/you/Desktop,/Users/you/Documents,/Users/you/Downloads,/Users/you/Library/Mobile Documents/com~apple~CloudDocs",        "APPLE_FILES_MCP_SAFETY_MODE": "safe_manage",        "APPLE_SYSTEM_MCP_SAFETY_MODE": "safe_manage",        "APPLE_CONTACTS_MCP_SAFETY_MODE": "safe_manage",        "APPLE_NOTES_MCP_SAFETY_MODE": "full_access",        "APPLE_MESSAGES_MCP_SAFETY_MODE": "full_access",        "APPLE_SHORTCUTS_MCP_SAFETY_MODE": "full_access"      }    }  }}

These values are the defaults for uvx and pip installs, so you only need the lines you want to change. With these values, replies and forwards are saved as drafts for you to send. To let the assistant send email itself, set APPLE_MAIL_MCP_SAFETY_PROFILE to full_access. The Claude Desktop bundle defaults Mail to full_access, as earlier bundles did; change it under Settings > Extensions > Apple Tools > Configure. Restart the client after changing env.

Running from a clone instead? Use /path/to/Apple-MCPs/Apple-Tools-MCP/start.sh as the command with empty args.

Claude Code example
bash
claude mcp add --transport stdio --scope user apple-tools -- uvx apple-tools-mcp

--scope user makes the server available in every project. To share it with one repository through its .mcp.json instead, use --scope project.

What It Exposes

  • Health and overview tools across all apps
  • Cross-app prompts
  • Delegated tools from Mail, Calendar, Reminders, Messages, Contacts, Notes, Shortcuts, Files, System, and Maps
  • Suggestions and permission guides
  • Files, System, and Maps resources and prompts
  • Unified wrappers for Focus, system context, Finder reveal, file open, and file tagging
  • Preference tools: get, detect, and update defaults and contact preferences
  • Communication tools: prepare, send, preview
  • Workflow tools: archive, create reminders and notes with defaults, preview those defaulted writes, capture follow-ups, preview follow-up capture, and summarize event collaboration
  • Launch-hardening tools: strict Maps wrappers, duplicate-contact detection, digest-folder helpers, and Shortcut bridge routing
  • Audit tools: list recent actions and undo
  • Briefing tools: daily, weekly, and communications triage
  • Prompt fallback: apple_list_prompts and apple_get_prompt
  • Mail thread tools: get, reply, archive
  • Contacts mutation: create, update, delete with labeled methods
  • Calendar and Messages permission diagnostics
  • Contacts names on Messages: participants and senders carry display_name / contact_id when Contacts access is already granted, and every Messages response says why names are missing in contact_names_status (ok, permission_denied, unavailable). Only exact owners are named; a number in a different area code never borrows a contact's name.
  • Launch and recovery: apple_health, apple_permission_guide, apple_recheck_permissions

Assistant Defaults

Apple-Tools-MCP can persist a lightweight assistant state file with defaults for:

  • default mail account
  • default archive mailbox
  • default calendar
  • default reminders list
  • default notes folder
  • preferred communication channel, messages, mail, or auto
  • preferred message target type, phone, email, or auto
  • per-contact preferred channel and target overrides for specific people

apple_detect_defaults() returns saved preferences with probe_status: "not_probed" and does not write the state file. To discover and persist missing targets, call apple_detect_defaults(probe_apps=true) after the user requests that discovery. This explicit probe may open Mail or Notes and request macOS permissions. The tool advertises that it can write preferences. Use apple_get_preferences to inspect defaults and apple_update_preferences to set them directly.

apple_health, apple_recheck_permissions, apple_overview, and apple://overview do not send Apple Events to apps or request new permissions. Overview keeps its resource keys but returns ok: false and status: "not_probed" for permission-sensitive app data. Read the named domain resource or tool when the user requests that data. Recent-file scans are also deferred because protected folders can require permission. Shortcuts library enumeration is also deferred. Its explicit shortcuts://all resource can run several CLI commands with a default 300-second timeout per command. Maps availability metadata remains included. Explicit app operations retain their permission checks and may launch the requested app.

When a reminder or note operation needs a missing destination, it discovers defaults only for that domain.

By default the state file is stored at ~/.apple-tools-mcp/preferences.json. Override it with APPLE_AGENT_MCP_STATE_FILE.

Apple-Tools-MCP also stores recent assistant actions in ~/.apple-tools-mcp/actions.json so the unified server can expose audit history and undo for reversible operations.

Archive, reminder, note, and Mail follow-up previews leave saved preferences and action history unchanged, including when defaults must be discovered or a destination cannot be resolved. An explicit reminder-list or notes-folder ID uses its saved label only when it matches the default; other IDs appear directly in the preview.

Archive discovery stays within the selected account. An explicit account override does not reuse another account's saved archive mailbox or replace saved defaults. If that account has no discoverable archive, pass its mailbox explicitly.

How to Work With It

  • Resolve people through Contacts first, then decide between Messages or Mail based on saved defaults.
  • Set per-contact preferences for people who always prefer a specific channel.
  • Preview risky actions and defaulted create flows when the client wants confirmation.
  • Use Mail thread helpers when the user refers to a conversation, not a single message.
  • Set defaults early (archive mailbox, calendar, reminders list, notes folder) so the assistant doesn't keep asking.
  • Keep contact info current so communication routing works reliably.
  • Use Files before Mail, Messages, Notes, or Shortcuts when the request involves local documents.
  • Check System context before interruptive actions, especially when the frontmost app, clipboard, or battery state matters.
  • Treat Focus support as truthful best-effort. Use it when available, and do not invent a current Focus mode if the MCP reports unsupported on the local setup.
  • Use apple_update_system_setting for macOS preference changes and apple_control_frontmost_app only when a native app-domain tool cannot complete the task.
  • Prefer explicit System settings tools over generic GUI automation when the request is really a macOS preference change.
  • Use GUI fallback tools only when the native domain MCP cannot complete the task and the client has granted Accessibility access. Name the target app with application or bundle_id; it must be listed in APPLE_SYSTEM_MCP_GUI_ALLOWED_APPS (see GUI input).
  • Use native Maps MCP tools for maps search and directions. Do not substitute shell, web, or external map providers when validating supported Maps behavior.
  • Use Shortcuts as the explicit bridge when native domain support is missing, rather than ad hoc shell or GUI work.
  • Use the dedicated digest folder helpers before saving daily or weekly briefings into Notes.
  • Use Maps when routing or travel time affects scheduling or communication.
  • Use apple_list_recent_actions and apple_undo_action for reversible operations.
  • When Mail must use a specific sender identity, pass the exact sender email in from_account, not just an account nickname.

macOS Permissions

  • Mail needs Automation access to Mail
  • Calendar needs Calendar access
  • Reminders needs Reminders access
  • Messages needs Automation access to Messages, plus Full Disk Access for history and reliable file sending
  • Contacts needs Contacts access
  • Contacts names on Messages responses need an explicit Contacts tool to run first (it builds the Contacts helper and asks for access); Messages reads never build the helper or ask for access, they report contact_names_status instead
  • Notes needs Automation access to Notes
  • Shortcuts usually works without a separate privacy prompt; it writes run output only inside APPLE_FILES_MCP_ALLOWED_ROOTS unless APPLE_SHORTCUTS_MCP_ALLOWED_ROOTS is set
  • Messages sends attachments only from inside APPLE_FILES_MCP_ALLOWED_ROOTS unless APPLE_MESSAGES_MCP_ALLOWED_ROOTS is set
  • Files access is controlled by APPLE_FILES_MCP_ALLOWED_ROOTS, not by a macOS privacy prompt
  • System actions may trigger System Events, Accessibility, or automation prompts depending on the host app
  • Focus status is best-effort and truthful on unsigned local installs
  • Notification Center history is not claimed where macOS does not expose it cleanly
  • Maps does not need a privacy prompt, but search and directions require the local Swift helper to compile

Launch Checklist

  • Add uvx apple-tools-mcp (or a clone's Apple-Tools-MCP/start.sh / installed .venv/bin/apple-tools-mcp entrypoint) to your MCP client
  • Reload or reconnect the client so the Apple-Tools-MCP tool surface is loaded into context
  • Call apple_health first to verify every domain
  • If a domain is blocked, call apple_permission_guide
  • After changing macOS permissions, call apple_recheck_permissions

Transports and Protocol Verification

stdio is the default and recommended transport. Set APPLE_AGENT_MCP_TRANSPORT=streamable-http (with optional APPLE_AGENT_MCP_HOST and APPLE_AGENT_MCP_PORT) to serve Streamable HTTP instead — used below for protocol validation.

Official MCP conformance

Start Apple-Tools-MCP in conformance mode:

bash
cd /path/to/Apple-MCPs/Apple-Tools-MCPAPPLE_AGENT_MCP_TRANSPORT=streamable-http \APPLE_AGENT_MCP_PORT=8765 \APPLE_AGENT_MCP_CONFORMANCE_MODE=1 \./start.sh

Then run the official active suite:

bash
npx -y @modelcontextprotocol/conformance server \  --url http://127.0.0.1:8765/mcp \  --suite active

APPLE_AGENT_MCP_CONFORMANCE_MODE=1 adds an opt-in MCP conformance surface covering content types, resources, resource templates, prompts, progress, and completion (fixtures for features removed by spec 2026-07-28 are intentionally absent). It is intended for CI and protocol testing, not normal assistant use.

The briefing and triage tools (apple_generate_daily_briefing, apple_generate_weekly_briefing, apple_triage_communications_task) are standard synchronous tools — the experimental MCP tasks API they previously used was removed from the spec (SEP-1686) and SDK, with the same tool names and results.

Launch Docs

Inspector CLI smoke check

From this server directory:

bash
npx -y @modelcontextprotocol/inspector --cli bash ./start.sh --method tools/listnpx -y @modelcontextprotocol/inspector --cli bash ./start.sh --method prompts/listnpx -y @modelcontextprotocol/inspector --cli bash ./start.sh --method resources/list

For the full repo-wide smoke pass, run:

bash
cd /path/to/Apple-MCPsbash scripts/inspector_smoke.sh

Agent Routing Prompt

xml
<apple_tools>`tools/list` returns the full tool surface. If context is constrained, use `search_tools` first, then `get_tool_info` only for the tools you plan to call.
<routing>  <imessage trigger="text, message, msg, iMessage">    Resolve recipient via Contacts first. Confirm if multiple matches.    Omit service_name parameter entirely.  </imessage>
  <contacts trigger="lookup, phone number, email, contact">    Run before any iMessage or Mail action.  </contacts>
  <mail trigger="email, mail, inbox, draft, reply">    Search requires a query string (sender, subject, or "*" as wildcard). No list-all endpoint.    If text vs. email is ambiguous, ask once.  </mail>
  <calendar trigger="calendar, event, schedule, appointment, meeting, block time">    Confirm date, time, duration, and title before writing.  </calendar>
  <reminders trigger="remind me, task, to-do, don't forget">    Reminders are organized into lists. Identify available lists on first use and set a default.    due_date requires timezone offset: yyyy-MM-ddTHH:mm:ss-HH:00  </reminders>
  <notes trigger="note, jot down, write this down, save this">    Multiple accounts may have a "Notes" folder. Identify them on first use and set a default.    Use for reference only. Time-sensitive items go to Reminders or Calendar.  </notes>
  <shortcuts trigger="shortcut, automation, run shortcut">    List available shortcuts before running if request is vague.  </shortcuts>
  <files trigger="file, folder, attachment, document, download, desktop">    Use Files before Mail, Messages, Notes, or Shortcuts when the request references local paths or attachments.    Confirm the exact path before mutation or send actions.  </files>
  <system trigger="clipboard, frontmost app, battery, notification, open app">    Use System when local desktop context affects the next action.    Keep writes scoped unless the user clearly asked for a notification, clipboard update, or app launch.  </system>
  <maps trigger="map, directions, route, commute, eta, address, place">    Use Maps when place lookup or travel time affects scheduling or communication.    Confirm origin, destination, and transport mode for time-sensitive plans.  </maps></routing>
<disambiguation>  1. Has due date/time -> Reminders  2. Reference material, no action -> Notes  3. Involves another person -> iMessage or Mail (Contacts first)  4. Text vs. email unclear -> ask once</disambiguation>
<known_gotchas>  - service_name on iMessage calls causes error (-1728). Omit it.  - Bare timestamps without timezone offset fail on Reminders.  - Mail has no "list recent" endpoint. Always pass a search query.  - Use `search_tools` plus `get_tool_info` to inspect tools without loading every schema into context.  - Multiple Notes folders exist across accounts. Pick one default.  - Files access is limited to APPLE_FILES_MCP_ALLOWED_ROOTS.  - Some System actions depend on host app automation approval.  - GUI input needs application or bundle_id, and the app must be in APPLE_SYSTEM_MCP_GUI_ALLOWED_APPS. Terminals and script editors are always refused.  - Maps search and directions depend on the local Swift helper and Xcode command line tools.</known_gotchas></apple_tools>

Related Servers

GUI input

apple_control_frontmost_app and the delegated system_gui_* input tools send input only to apps listed in APPLE_SYSTEM_MCP_GUI_ALLOWED_APPS. It is empty by default, so GUI input is off until you set it. Listing menu bar items (list_menu_bar_items) only reads and needs no allowlist.

  • Format: comma-separated bundle ids, for example com.apple.TextEdit,com.apple.Safari. To find an app's bundle id, run osascript -e 'id of app "TextEdit"'.
  • Where to set it: the env block of this server in your MCP client config, for example "APPLE_SYSTEM_MCP_GUI_ALLOWED_APPS": "com.apple.TextEdit,com.apple.Safari". In Claude Desktop, open Settings > Extensions, configure Apple Tools and fill in "Apps that accept GUI input". Restart the client afterwards.
  • application or bundle_id is required for every input action (click_menu_path, press_keys, type_text, click_button, choose_popup_value). Input is never sent to whatever app happens to be frontmost.
  • Terminals, script editors and automation apps (Terminal, iTerm2, Ghostty, Warp, Script Editor, Automator, Shortcuts, Xcode, VS Code, Cursor, JetBrains IDEs, Raycast, Alfred and similar) are always refused, even if allow-listed.

Mail attachments

Set APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT to a dedicated directory before attaching local files to a draft or outgoing message. Attachments are disabled when this variable is unset. The same directory restriction applies to the standalone Mail server and the unified Apple Tools server.

Select a calendar by its displayed name and source in calendar_list_calendars, then pass its returned calendar_id unchanged. Re-list calendars after changing Calendar permissions and restarting the MCP server. For full alarm edits, list events with a native calendar ID and use the returned native event ID; existing applescript:: IDs continue to use automation. See Selecting calendar and event identifiers.

Calendar alarm edits follow the standalone server contract: full editing and combined explicit-alarm/field updates require native EventKit. In the automation fallback, omit alarms for ordinary field edits. Alarm-only initial alerts and empty-list no-ops require every alert collection to be readable and empty. Failed insertion or an interrupted mutation can have an unknown outcome; inspect the event before retrying. See Calendar alarm support.

Source: Apple-Tools-MCP/README.md at commit 96b9cdb

Tools

184

apple_get_preferences

Apple Get Preferences

Read the persisted Apple-Tools assistant defaults and routing preferences.

Takes no parameters.

apple_detect_defaults

Apple Detect Defaults

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.

Parametersprobe_apps

apple_update_preferences

Apple Update Preferences

Persist assistant defaults such as default lists, folders, calendars, archive mailboxes, and preferred communication routing.

Parametersdefault_calendar_iddefault_mail_accountdefault_calendar_namedefault_archive_accountdefault_archive_mailboxdefault_notes_folder_iddefault_digest_folder_iddefault_reminder_list_iddefault_notes_folder_namepreferred_message_channeldefault_digest_folder_namedefault_notes_account_name+3 more

apple_detect_digest_folder

Apple Detect Digest Folder

Detect the preferred Notes folder for daily and weekly digests, and persist it if found.

Takes no parameters.

apple_set_digest_folder

Apple Set Digest Folder

Persist the dedicated Notes folder that Apple-Tools should use for daily and weekly digests.

Parametersfolder_idrequiredfolder_nameaccount_name

apple_ensure_digest_folder

Apple Ensure Digest Folder

Ensure a dedicated Notes folder exists for daily and weekly digests, creating it when necessary and persisting the preference.

Parametersfolder_nameaccount_name

apple_update_contact_preferences

Apple Update Contact Preferences

Persist preferred communication routing for a specific contact so Apple-Tools can choose the right channel and target for that person.

Parameterscontact_idrequiredclear_existingpreferred_mail_addresspreferred_message_targetpreferred_message_channelpreferred_communication_channel

apple_prepare_communication

Apple Prepare Communication

Resolve a recipient through Contacts, evaluate available channels, and return the recommended mail or messages target before sending.

Parametersrecipientrequiredpreferred_channel

apple_preview_communication

Apple Preview Communication

Preview how Apple-Tools will route a communication before sending it through Messages or Mail.

Parametersmessagerequiredsubjectrecipientrequiredattachmentsfrom_accountpreferred_channel

apple_preview_archive_message

Apple Preview Archive Message

Preview how Apple-Tools will archive a Mail message before moving it.

Parametersmessage_idrequiredarchive_accountarchive_mailbox

apple_preview_create_reminder_with_defaults

Apple Preview Create Reminder With Defaults

Preview how Apple-Tools will create a reminder with the configured default reminder list.

Parametersnotestitlerequiredlist_iddue_datepriority

apple_preview_create_note_with_defaults

Apple Preview Create Note With Defaults

Preview how Apple-Tools will create a note with the configured default notes folder.

Parameterstagstitlerequiredbody_htmlbody_textfolder_id

apple_preview_follow_up_from_mail

Apple Preview Follow-Up From Mail

Preview how Apple-Tools will turn an email into a reminder and note before creating either item.

Parametersdue_datemessage_idrequirednote_titlecreate_notereminder_titlecreate_reminder

apple_send_communication

Apple Send Communication

Send a communication through Messages or Mail using Contacts resolution and assistant defaults.

Parametersmessagerequiredsubjectrecipientrequiredattachmentsfrom_accountpreferred_channel

apple_archive_message

Apple Archive Message

Move a message to the preferred archive mailbox, or auto-detect an archive mailbox if no preference exists yet.

Parametersmessage_idrequiredarchive_accountarchive_mailbox

apple_list_recent_actions

Apple List Recent Actions

List recent assistant actions recorded by Apple-Tools for audit and undo workflows.

Parameterslimit

apple_undo_action

Apple Undo Action

Undo a recent Apple-Tools action when the underlying standalone MCPs support a reliable reversal.

Parametersaction_idrequired

apple_create_reminder_with_defaults

Apple Create Reminder With Defaults

Create a reminder using the configured default reminder list when list_id is omitted.

Parametersnotestitlerequiredlist_iddue_datepriority

apple_create_note_with_defaults

Apple Create Note With Defaults

Create a note using the configured default notes folder when folder_id is omitted.

Parameterstagstitlerequiredbody_htmlbody_textfolder_id

apple_capture_follow_up_from_mail

Apple Capture Follow-Up From Mail

Turn an email into a reminder and an archival note using assistant defaults for the destination list and notes folder.

Parametersdue_datemessage_idrequirednote_titlecreate_notereminder_titlecreate_reminder

apple_event_collaboration_summary

Apple Event Collaboration Summary

Summarize attendee state for a shared calendar event so agents can verify collaboration and participation.

Parametersevent_idrequired

apple_maps_search_places_strict

Apple Maps Search Places Strict

Search places through the native Apple Maps MCP and fail closed if the Maps helper is unavailable.

Parameterslimitqueryrequired

apple_maps_get_directions_strict

Apple Maps Get Directions Strict

Get directions through the native Apple Maps MCP and fail closed if the Maps helper is unavailable.

Parametersoriginrequiredtransportdestinationrequired

apple_find_duplicate_contacts

Apple Find Duplicate Contacts

Find likely duplicate contacts through Apple Contacts so assistants can disambiguate people before acting.

Parametersquerymerge_candidates_only

apple_prepare_unique_contact

Apple Prepare Unique Contact

Resolve a contact for a person-targeted workflow, but stop and return duplicate groups if likely duplicate records need cleanup first.

Parametersqueryrequired

apple_list_shortcuts_for_capability

Apple List Shortcuts For Capability

List likely shortcuts for a requested capability so Apple-Tools can use Shortcuts as an intentional bridge when native coverage is missing.

Parameterslimitqueryrequired

apple_route_or_run_shortcut

Apple Route Or Run Shortcut

Use Apple Shortcuts as the explicit bridge when native Apple MCP coverage is insufficient or when the user names a shortcut directly.

Parametersdry_runrequestrequiredinput_textinput_pathsshortcut_name_or_identifier

apple_open_application

Apple Open Application

Open an application through the unified Apple control plane using its name or bundle identifier.

Parametersbundle_idapplication

apple_get_focus_status

Apple Get Focus Status

Return truthful Focus support metadata through the unified Apple control plane.

Takes no parameters.

apple_get_system_context

Apple Get System Context

Return a richer Apple system context snapshot, including Focus, frontmost app, and battery state.

Takes no parameters.

apple_open_file_path

Apple Open File Path

Open a file or folder through Apple Files and return iCloud-aware path metadata.

Parameterspathrequired

apple_reveal_in_finder

Apple Reveal In Finder

Reveal a file or folder in Finder through Apple Files.

Parameterspathrequired

apple_tag_file

Apple Tag File

Read, replace, add, or remove Finder tags on a file or folder through Apple Files.

Parameterspathrequiredtagsaction

apple_update_system_setting

Apple Update System Setting

Apply an assistant-relevant macOS setting through the unified Apple control plane.

Parametersmodeenabledsettingrequired

apple_control_frontmost_app

Apple Control Frontmost App

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.

Parameterskeytextindexlabelvalueactionrequiredbundle_idmenu_pathmodifiersapplicationdescription

apple_suggest_mailboxes

Apple Suggest Mailboxes

Apple Suggest Mailboxes using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

Parameterslimitquery

apple_suggest_calendars

Apple Suggest Calendars

Apple Suggest Calendars using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

Parameterslimitquery

apple_suggest_reminder_lists

Apple Suggest Reminder Lists

Apple Suggest Reminder Lists using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

Parameterslimitquery

apple_suggest_shortcuts

Apple Suggest Shortcuts

Apple Suggest Shortcuts using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

Parameterslimitquery

apple_suggest_contacts

Apple Suggest Contacts

Apple Suggest Contacts using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

Parameterslimitquery

apple_suggest_note_folders

Apple Suggest Note Folders

Apple Suggest Note Folders using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

Parameterslimitquery

apple_suggest_message_conversations

Apple Suggest Message Conversations

Apple Suggest Message Conversations using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

Parameterslimitquery

apple_suggest_files

Apple Suggest Files

Apple Suggest Files using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

Parameterslimitquery

apple_suggest_running_apps

Apple Suggest Running Apps

Apple Suggest Running Apps using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

Parameterslimitquery

apple_suggest_places

Apple Suggest Places

Apple Suggest Places using the current Apple data surfaces. This is a completion fallback for clients without MCP completion support.

Parameterslimitquery

apple_permission_guide

Apple Permission Guide

Explain how to grant the Apple permissions needed by a given Apple domain on macOS.

Parametersdomain

apple_recheck_permissions

Apple Recheck Permissions

Recheck Apple domain health after the user changes macOS permissions, and notify the client that Apple resources changed.

Takes no parameters.

apple_send_message_interactive

Apple Send Message Interactive

Send an Apple Messages message, asking for missing recipient or text when needed.

Parameterstextrecipient

apple_create_event_interactive

Apple Create Event Interactive

Create a Calendar event, asking for missing event details when needed.

Parametersnotestitleall_dayend_isolocationstart_isocalendar_id

apple_health

Apple Health

Report aggregated health across the unified Apple ecosystem MCP domains.

Takes no parameters.

apple_overview

Apple Overview

Return domain health and saved preferences; defer permission-sensitive data reads and Shortcuts library enumeration.

Takes no parameters.

apple_generate_daily_briefing

Apple Generate Daily Briefing

Generate a daily Apple briefing from today's context, domain health, and Mail highlights.

Parametersmail_limitmail_query

apple_generate_weekly_briefing

Apple Generate Weekly Briefing

Generate a weekly Apple briefing from upcoming events, reminders, and Mail highlights.

Parametersdaysmail_limitmail_query

apple_triage_communications_task

Apple Triage Communications Task

Generate a cross-app communications triage summary from unread Messages and Mail search results.

Parametersmail_limitmail_queryconversation_limit

mail_health

Mail Health

Report the active Apple Mail MCP configuration.

Takes no parameters.

mail_list_mailboxes

List Mailboxes

List Apple Mail mailboxes, optionally filtered by account.

Parametersaccount

mail_search_messages

Search Mail

Search Apple Mail messages by query with optional account, mailbox and unread filters. Without account, accounts are searched in Mail's order and the limit can be filled by the first one; pass account (as returned by mail_list_mailboxes) to search a specific account.

Parameterslimitqueryrequiredaccountmailboxunread_only

mail_get_message

Get Email

Fetch a single Apple Mail message by message_id.

Parametersmessage_idrequired

mail_get_thread

Get Thread

Find related messages in the same mailbox thread by normalized subject, anchored on a message_id.

Parameterslimitmessage_idrequired

mail_compose_draft

Compose Draft

Create a draft message in Apple Mail without sending it. Optionally specify from_account as an email address or account name to set the sender.

Parameterscctorequiredbccbodysubjectattachmentsfrom_account

mail_reply_message

Reply to Message

Reply to an existing email message. Provide a message_id and body text. Set reply_all=true to reply to all recipients. Optionally specify from_account. In full_access the reply is sent; in safe_manage it is saved as an unsent draft in Mail for the user to review (check `sent` and `note` in the result).

Parametersbodyrequiredreply_allmessage_idrequiredfrom_account

mail_reply_latest_in_thread

Reply To Latest In Thread

Find the latest related message in the same mailbox thread and reply to that message. In full_access the reply is sent; in safe_manage it is saved as an unsent draft in Mail for the user to review (check `sent` and `note` in the result).

Parametersbodyrequiredlimitreply_allmessage_idrequiredfrom_account

mail_forward_message

Forward Message

Forward an existing email message to new recipients. Provide a message_id and the to list. Optionally prepend body text and specify from_account. In full_access the forward is sent; in safe_manage it is saved as an unsent draft in Mail for the user to review (check `sent` and `note` in the result).

Parameterstorequiredbodymessage_idrequiredfrom_account

mail_mark_message

Mark Message Read/Unread

Set the read status of an email message. Pass is_read=true to mark as read, is_read=false to mark as unread.

Parametersis_readrequiredmessage_idrequired

mail_move_message

Move Message

Move an email message to a different mailbox. Optionally specify target_account if the mailbox is in a different account.

Parametersmessage_idrequiredtarget_accounttarget_mailboxrequired

mail_archive_thread

Archive Thread

Move related messages in the same mailbox thread to the target archive mailbox.

Parameterslimitmessage_idrequiredarchive_accountarchive_mailbox

mail_delete_message

Delete Message

Delete (trash) an email message by its message_id.

Parametersmessage_idrequired

mail_send_message

Send Email

Send an email immediately via Apple Mail. Optionally specify from_account as an email address or account name to set the sender.

Parameterscctorequiredbccbodysubjectattachmentsfrom_account

calendar_health

Calendar Health

Report the active Apple Calendar server configuration.

Takes no parameters.

calendar_list_calendars

List Calendars

List available Apple Calendar calendars. Select by name and source, then pass the returned calendar_id unchanged. Re-list after Calendar access changes to refresh identifiers.

Takes no parameters.

calendar_list_events

List Events

List calendar events in a time window, optionally filtered to one calendar. Use calendar_id from calendar_list_calendars. Listing through native EventKit returns native event IDs for full alarm edits.

Parameterslimitend_isorequiredstart_isorequiredcalendar_id

calendar_get_event

Get Event

Fetch full details for a calendar event by event_id.

Parametersevent_idrequired

calendar_create_event

Create Event

Create a new event in a specific Apple Calendar calendar. Use the exact calendar_id returned by calendar_list_calendars. With native access, a unique calendar name resolves to its native calendar; duplicate names return AMBIGUOUS_CALENDAR. Optional alarms: list of {minutes_before: N} or {absolute_iso: ISO datetime}. Automation can add initial display alerts only when no inherited alerts need removal; full alarm editing requires native EventKit access.

Parametersnotestitlerequiredalarmsall_dayend_isorequiredlocationstart_isorequiredrecurrencecalendar_idrequired

calendar_update_event

Update Event

Update one or more fields on an existing calendar event. For full alarm edits, list events using a native calendar_id and pass the returned native event_id. Existing applescript:: IDs continue to use automation after access changes. Optional alarms: list of {minutes_before: N} or {absolute_iso: ISO datetime}; pass [] to clear alarms, omit to leave unchanged. Replacing or clearing existing alarms, or combining explicit alarms with other field edits, requires native EventKit access. Automation rejects combined requests before any mutation, including [] or unchanged field values. Omit alarms for ordinary field edits; alarm-only initial alerts or [] no-ops require all alert collections verified empty. For a repeating event (recurring: true in calendar_list_events), pass scope and, for one occurrence or those following it, occurrence_start_iso. Without scope, the user is asked to choose when the client supports forms; otherwise the call returns RECURRING_EVENT_SCOPE_REQUIRED and nothing changes.

Parametersnotesscopetitlealarmsall_dayend_isoevent_idrequiredlocationstart_isorecurrencecalendar_idoccurrence_start_iso

calendar_delete_event

Delete Event

Delete a calendar event by event_id. For a repeating event (recurring: true in calendar_list_events), pass scope and, for one occurrence or those following it, occurrence_start_iso. Without scope, the user is asked to choose when the client supports forms; otherwise the call returns RECURRING_EVENT_SCOPE_REQUIRED and nothing changes.

Parametersscopeevent_idrequiredoccurrence_start_iso

reminders_health

Reminders Health

Report the active Apple Reminders MCP server configuration.

Takes no parameters.

reminders_list_lists

List Reminder Lists

List available Apple Reminders lists.

Takes no parameters.

reminders_create_list

Create Reminder List

Create a new Apple Reminders list.

Parameterstitlerequired

reminders_delete_list

Delete Reminder List

Delete a reminder list entirely. Requires full_access safety mode.

Parameterslist_idrequired

reminders_list_reminders

List Reminders

List reminders with optional list and due-date filters.

Parameterslimitsearchlist_iddue_afterdue_beforeinclude_completed

reminders_get_reminder

Get Reminder

Fetch full details for a reminder by reminder_id.

Parametersreminder_idrequired

reminders_create_reminder

Create Reminder

Create a new reminder in a specific Apple Reminders list.

Parameterstagsnotestitlerequiredlist_idrequireddue_datepriorityremind_atdue_all_dayparent_reminder_id

reminders_update_reminder

Update Reminder

Update one or more fields on an existing reminder.

Parameterstagsnotestitlelist_iddue_datepriorityremind_atdue_all_dayreminder_idrequiredparent_reminder_id

reminders_complete_reminder

Complete Reminder

Mark a reminder as completed.

Parametersreminder_idrequired

reminders_uncomplete_reminder

Uncomplete Reminder

Mark a reminder as not completed.

Parametersreminder_idrequired

reminders_delete_reminder

Delete Reminder

Delete a reminder by reminder_id.

Parametersreminder_idrequired

shortcuts_health

Shortcuts Health

Report the active Apple Shortcuts MCP configuration.

Takes no parameters.

shortcuts_list_shortcuts

List Shortcuts

List Apple Shortcuts, optionally restricted to one folder.

Parametersfolder_name

shortcuts_list_folders

List Shortcut Folders

List Apple Shortcuts folders.

Takes no parameters.

shortcuts_view_shortcut

View Shortcut

Open a shortcut in the Shortcuts app by name or identifier and return its metadata.

Parametersshortcut_name_or_identifierrequired

shortcuts_run_shortcut

Run Shortcut

Run a shortcut by name or identifier with optional input and output arguments.

Parametersinput_textinput_pathsoutput_pathoutput_typeshortcut_name_or_identifierrequired

files_health

Files Health

Report the active Apple Files MCP configuration.

Takes no parameters.

files_list_allowed_roots

List Allowed Roots

List the file system roots the server may access.

Takes no parameters.

files_list_directory

List Directory

List files and folders inside an allowed directory path.

Parameterspathrequired

files_search_files

Search Files

Search file and folder names inside the allowed roots.

Parameterslimitqueryrequiredbase_path

files_get_file_info

Get File Info

Get metadata for a file or folder inside the allowed roots.

Parameterspathrequired

files_read_text_file

Read Text File

Read a UTF-8 text file inside the allowed roots.

Parameterspathrequiredmax_bytes

files_recent_files

Recent Files

List recently modified files inside the allowed roots.

Parameterslimit

files_get_tags

Get Tags

Read Finder tags for a file or folder inside the allowed roots.

Parameterspathrequired

files_list_recent_locations

List Recent Locations

List recently active parent folders across the allowed roots, including iCloud-aware metadata.

Parameterslimit

files_get_icloud_status

Get iCloud Status

Report whether local iCloud Drive is available and whether it is part of the current allowed roots.

Takes no parameters.

files_create_folder

Create Folder

Create a folder inside the allowed roots.

Parameterspathrequired

files_move_path

Move Path

Move or rename a file or folder inside the allowed roots.

Parameterssourcerequireddestinationrequired

files_open_path

Open Path

Open a file or folder in the default app. Requires safe_manage or full_access safety mode.

Parameterspathrequired

files_reveal_in_finder

Reveal In Finder

Reveal a file or folder in Finder. Requires safe_manage or full_access safety mode.

Parameterspathrequired

files_set_tags

Set Tags

Replace Finder tags for a file or folder. Requires safe_manage or full_access safety mode.

Parameterspathrequiredtagsrequired

files_add_tags

Add Tags

Add Finder tags to a file or folder. Requires safe_manage or full_access safety mode.

Parameterspathrequiredtagsrequired

files_remove_tags

Remove Tags

Remove Finder tags from a file or folder. Requires safe_manage or full_access safety mode.

Parameterspathrequiredtagsrequired

files_delete_path

Delete Path

Delete a file or empty folder inside the allowed roots. Requires full_access safety mode.

Parameterspathrequired

system_health

System Health

Report the active Apple System MCP configuration.

Takes no parameters.

system_status

System Status

Return current battery, frontmost app, and running app count.

Takes no parameters.

system_get_battery

Get Battery

Get the current battery state from macOS.

Takes no parameters.

system_get_frontmost_app

Get Frontmost App

Get the name of the current frontmost application.

Takes no parameters.

system_list_running_apps

List Running Apps

List currently running foreground applications.

Takes no parameters.

system_get_clipboard

Get Clipboard

Read the current text clipboard contents.

Takes no parameters.

system_list_settings_domains

List Settings Domains

List the common macOS preference domains exposed by Apple System MCP.

Takes no parameters.

system_get_appearance_settings

Get Appearance Settings

Read current macOS appearance settings such as light or dark mode and accent color.

Takes no parameters.

system_get_accessibility_settings

Get Accessibility Settings

Read common macOS accessibility settings such as reduce motion and increase contrast.

Takes no parameters.

system_get_dock_settings

Get Dock Settings

Read common macOS Dock settings such as autohide, magnification, and orientation.

Takes no parameters.

system_get_finder_settings

Get Finder Settings

Read common macOS Finder settings such as path bar, status bar, and preferred view style.

Takes no parameters.

system_get_settings_snapshot

Get Settings Snapshot

Return a combined read-only snapshot of appearance, accessibility, Dock, and Finder settings.

Takes no parameters.

system_get_focus_status

Get Focus Status

Return truthful Focus support metadata and the best available current Focus state.

Takes no parameters.

system_get_context_snapshot

Get System Context Snapshot

Return a richer macOS context snapshot, including battery, frontmost app, and Focus metadata.

Takes no parameters.

system_read_preference_domain

Read Preference Domain

Read a macOS preference domain through defaults export for a production-safe, structured settings view.

Parametersdomainrequiredcurrent_host

system_set_appearance_mode

Set Appearance Mode

Set macOS appearance mode to light or dark.

Parametersmoderequired

system_set_show_all_extensions

Set Show All Extensions

Show or hide filename extensions in macOS.

Parametersenabledrequired

system_set_show_hidden_files

Set Show Hidden Files

Show or hide hidden files in Finder.

Parametersenabledrequired

system_set_finder_path_bar

Set Finder Path Bar

Show or hide the Finder path bar.

Parametersenabledrequired

system_set_finder_status_bar

Set Finder Status Bar

Show or hide the Finder status bar.

Parametersenabledrequired

system_set_dock_autohide

Set Dock Autohide

Enable or disable Dock autohide.

Parametersenabledrequired

system_set_dock_show_recents

Set Dock Show Recents

Enable or disable recent applications in the Dock.

Parametersenabledrequired

system_set_reduce_motion

Set Reduce Motion

Enable or disable macOS reduce motion accessibility mode.

Parametersenabledrequired

system_set_increase_contrast

Set Increase Contrast

Enable or disable macOS increase contrast accessibility mode.

Parametersenabledrequired

system_set_reduce_transparency

Set Reduce Transparency

Enable or disable macOS reduce transparency accessibility mode.

Parametersenabledrequired

system_set_clipboard

Set Clipboard

Write text into the macOS clipboard.

Parameterstextrequired

system_show_notification

Show Notification

Display a local macOS notification.

Parametersbodyrequiredtitlerequiredsubtitle

system_open_application

Open Application

Open an application by name using macOS.

Parametersbundle_idapplication

system_gui_list_menu_bar_items

List Menu Bar Items

List the top-level menu bar items for an application. This is a GUI fallback tool.

Parametersbundle_idapplication

system_gui_click_menu_path

Click Menu Path

Click a menu path in a named application, for example ['File', 'New Window']. This is a GUI fallback tool. Requires 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). Input is never sent to the frontmost app implicitly. Terminals, script editors and automation apps are always refused, even if allow-listed.

Parametersbundle_idmenu_pathrequiredapplication

system_gui_press_keys

Press Keys

Press a key or key chord in a named application. This is a GUI fallback tool. Requires 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). Input is never sent to the frontmost app implicitly. Terminals, script editors and automation apps are always refused, even if allow-listed.

Parameterskeyrequiredbundle_idmodifiersapplication

system_gui_type_text

Type Text

Type text into the focused control of a named application. This is a GUI fallback tool. Requires 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). Input is never sent to the frontmost app implicitly. Terminals, script editors and automation apps are always refused, even if allow-listed.

Parameterstextrequiredbundle_idapplication

system_gui_click_button

Click Button

Click a named button in the front window of a named application. This is a GUI fallback tool. Requires 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). Input is never sent to the frontmost app implicitly. Terminals, script editors and automation apps are always refused, even if allow-listed.

Parametersindexlabelbundle_idapplicationdescription

system_gui_choose_popup_value

Choose Pop-Up Value

Choose a value from a named pop-up button in the front window of a named application. This is a GUI fallback tool. Requires 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). Input is never sent to the frontmost app implicitly. Terminals, script editors and automation apps are always refused, even if allow-listed.

Parameterslabelrequiredvaluerequiredbundle_idapplicationdescription

maps_health

Maps Health

Report the active Apple Maps MCP configuration.

Takes no parameters.

maps_search_places

Search Places

Search Apple Maps for matching places.

Parameterslimitqueryrequired

maps_get_directions

Get Directions

Get Apple Maps route details between an origin and destination.

Parametersoriginrequiredtransportdestinationrequired

maps_open_directions_in_maps

Open Directions In Maps

Open directions in the Apple Maps app.

Parametersorigintransportdestinationrequired

contacts_health

Contacts Health

Report the active Apple Contacts MCP configuration.

Takes no parameters.

contacts_list_contacts

List Contacts

List Apple Contacts entries.

Parameterslimitoffset

contacts_create_contact

Create Contact

Create a new contact in Apple Contacts with a first name (required) and optional last name, organization, and note.

Parametersnoteemailsphoneslast_namefirst_namerequiredorganization

contacts_update_contact

Update Contact

Update an existing contact's information. Only the fields you provide will be changed.

Parametersnoteemailsphoneslast_namecontact_idrequiredfirst_nameorganization

contacts_delete_contact

Delete Contact

Permanently delete a contact by contact_id. Requires full_access safety mode.

Parameterscontact_idrequired

contacts_search_contacts

Search Contacts

Search Apple Contacts by name, phone number, or email address.

Parameterslimitqueryrequired

contacts_get_contact

Get Contact

Fetch full details for an Apple Contacts record by contact_id.

Parameterscontact_idrequired

contacts_resolve_message_recipient

Resolve Message Recipient

Resolve a contact into a message-ready phone number or email address.

Parametersqueryrequiredchannel

notes_health

Notes Health

Report the active Apple Notes MCP configuration.

Takes no parameters.

notes_list_accounts

List Accounts

List Apple Notes accounts.

Takes no parameters.

notes_list_folders

List Folders

List Apple Notes folders.

Parameterslimitoffsetaccount_name

notes_list_notes

List Notes

List notes, optionally scoped to a folder or account.

Parameterslimitoffsetfolder_idaccount_name

notes_get_note

Get Note

Fetch full details for an Apple Notes note by note_id.

Parametersnote_idrequired

notes_search_notes

Search Notes

Search notes by text, folder, or account.

Parameterslimitqueryrequiredoffsetfolder_idaccount_name

notes_create_note

Create Note

Create a new note in a folder.

Parameterstagstitlerequiredbody_htmlfolder_idrequired

notes_append_to_note

Append to Note

Append plain text to an existing note without replacing its current content. Pass the text as body.

Parametersbodyrequirednote_idrequired

notes_update_note

Update Note

Update an existing note.

Parameterstagstitlenote_idrequiredbody_htmlfolder_id

notes_delete_note

Delete Note

Delete a note by note_id.

Parametersnote_idrequired

notes_move_note

Move Note

Move a note to a different folder.

Parametersnote_idrequiredfolder_idrequired

notes_create_folder

Create Notes Folder

Create a new folder in an Apple Notes account or nested folder.

Parametersfolder_namerequiredaccount_namerequiredparent_folder_id

notes_rename_folder

Rename Folder

Rename an existing folder.

Parametersfolder_idrequiredfolder_namerequired

notes_delete_folder

Delete Folder

Delete an Apple Notes folder.

Parametersfolder_idrequired

notes_list_attachments

List Note Attachments

List attachments for a note.

Parametersnote_idrequired

messages_health

Messages Health

Report Messages server configuration and capability status.

Takes no parameters.

messages_list_conversations

List Conversations

List recent Apple Messages conversations.

Parameterslimitoffsetunread_only

messages_get_conversation

Get Conversation

Fetch a single Apple Messages conversation with paginated messages.

Parameterslimitoffsetchat_idrequired

messages_search_messages

Search Messages

Search Apple Messages text history.

Parameterslimitqueryrequiredoffsetsenderchat_idend_isostart_iso

messages_get_message

Get Message

Fetch a single Apple Messages message by message_id.

Parametersmessage_idrequired

messages_list_attachments

List Message Attachments

List Apple Messages attachments by chat or message.

Parameterslimitoffsetchat_idmessage_id

messages_send_message

Send Message

Send a new message through Messages.app. Sends as iMessage unless service_name is set: SMS or RCS go through the iPhone's carrier and need Text Message Forwarding enabled for this Mac.

Parameterstextrequiredrecipientrequiredservice_name

messages_reply_in_conversation

Reply In Conversation

Reply to an Apple Messages conversation using its chat_id. Supports both one-to-one and group chats. One-to-one replies use the service of the thread's latest message (SMS/RCS threads stay SMS/RCS) unless service_name is set. Group replies always use the group's existing service; service_name is rejected for groups unless it matches.

Parameterstextrequiredchat_idrequiredservice_name

messages_send_attachment

Send Attachment

Send a file attachment via Apple Messages to a recipient. Optionally include a text message, which is sent after the file. Waits up to 20 seconds for Messages to confirm the transfer: ATTACHMENT_NOT_DELIVERED means the file failed, and SEND_STATUS_UNKNOWN means check the conversation before sending again.

Parameterstextfile_pathrequiredrecipientrequiredservice_name

apple_list_prompts

Apple List Prompts

Fallback prompt discovery tool for clients that only support tools.

Takes no parameters.

apple_get_prompt

Apple Get Prompt

Fallback prompt rendering tool for clients that only support tools.

Parametersnamerequiredarguments_json

search_tools

Search Tools

Search this server's tool catalog by keyword, alias, or domain tag.

Parametersmodelimitqueryrequireddomain_tags

get_tool_info

Get Tool Info

Load the full schema, examples, and metadata for one tool from this server.

Parametersnamerequiredinclude_schemainclude_examples

Version history

8
  1. v1.1.6LatestNov 6, 2026
  2. v1.1.4Oct 29, 2026
  3. v1.1.3Oct 22, 2026
  4. v1.1.2Oct 14, 2026
  5. v1.1.1Oct 13, 2026
  6. v1.1.0Oct 10, 2026
  7. v1.0.5Sep 26, 2026
  8. v1.0.4Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Unified integrations