Apple Tools (Unified)

io.github.JonathanRReed由 GitHub 帳號 JonathanRReed 發布v1.1.6更新於 Nov 7, 2026

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

發布方自己的服務：Core

已驗證STDIO僅桌面效率與工作流檔案與儲存溝通與協作

服務詳細資訊

識別碼: io.github.JonathanRReed/apple-tools-mcp
傳輸: STDIO
執行環境: Desktop only
信任: Verified
發布於: Sep 16, 2026

安全提示

MCP 服務會接收對話中的工具呼叫請求，並可能執行外部操作。啟用前請先了解該服務能做什麼，並只授予它所需的權限。

註冊中心已驗證此條目所屬的 GitHub 帳號 JonathanRReed。這並不表明該帳號就是產品方。

SourceWeft 的檢查只涵蓋條目是否完整、端點是否回應；不審查伺服器的程式碼，也不審查其工具的行為。

在 README 中新增徽章

向讀者展示該 MCP 服務已收錄於 SourceWeft，徽章連結到本頁。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.JonathanRReed%2Fapple-tools-mcp.svg)](https://sourceweft.com/mcp/io.github.JonathanRReed%2Fapple-tools-mcp?utm_source=readme&utm_medium=badge)

概覽

AI 產生的概覽

專為 macOS 設計的統一 MCP 伺服器，讓助理透過單一入口存取郵件、行事曆、提醒事項、訊息、聯絡人、備忘錄、捷徑、檔案、系統與地圖。

可以做什麼: 跨 Apple 應用程式讀取與操作：郵件搜尋、討論串、草稿與封存；行事曆事件；依已儲存預設值建立提醒事項與備忘錄
先透過聯絡人解析對象，再準備、預覽並傳送訊息或郵件，並可依聯絡人設定路由偏好
處理本機檔案與 Finder：開啟路徑、在 Finder 中顯示、編輯 Finder 標籤，並在允許的根目錄內加入附件
檢視前景應用程式、剪貼板、電池與專注模式等系統狀態，開啟應用程式、變更 macOS 設定，並執行受限的圖形介面備援輸入
透過 Apple 地圖搜尋地點與取得路線，原生能力不足時以捷徑作為橋接
預覽、稽核並復原近期操作，另提供每日與每週簡報及通訊分流
適用情境: 適合在一台 Mac 上跨多個 Apple 應用程式完成個人助理工作，例如把一封郵件轉成提醒事項與備忘錄、結合行事曆與提醒事項規劃一天，或把訊息導向正確的對象。也適合希望一次安裝就取代分別設定十個 Apple MCP 伺服器的使用者。
執行需求: 僅在 macOS 本機執行，可透過 PyPI 的 uvx 或 Claude Desktop 安裝包啟動；從複製的儲存庫或 start.sh 執行需 Python 3.11 以上。各領域需要對應的 macOS 權限：郵件、訊息與備忘錄需要自動化權限，另需行事曆、提醒事項與聯絡人存取權，訊息歷史還需完整磁碟存取權。地圖需要本機 Swift 輔助程式與 Xcode 命令列工具。行為透過環境變數調整，例如各領域的安全模式、APPLE_FILES_MCP_ALLOWED_ROOTS、APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT 與 APPLE_SYSTEM_MCP_GUI_ALLOWED_APPS。

安裝前請注意

它可以傳送訊息與郵件、建立與修改行事曆事件、提醒事項、備忘錄與聯絡人、封存郵件、變更 macOS 設定並送出圖形介面輸入，因此應審慎設定各領域的安全模式；Claude Desktop 安裝包預設把郵件設為 full_access，也就是允許助理自行寄信。圖形介面輸入預設關閉，需在 APPLE_SYSTEM_MCP_GUI_ALLOWED_APPS 中列出應用程式，終端機與腳本編輯器一律拒絕。檔案存取受 APPLE_FILES_MCP_ALLOWED_ROOTS 限制。偏好設定與操作紀錄存放在 ~/.apple-tools-mcp 下。授予完整磁碟存取與輔助使用權限會擴大助理可觸及的範圍。

安裝

在 SourceWeft 中

開啟儀表板中的 Apple Tools (Unified)，將其新增到工作區。
為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照儲存庫中的啟動說明。

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:

No clone, no venv management.

From a clone

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"      }    }  }}

{  "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

--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

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

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

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:

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>

<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.

來源：Apple-Tools-MCP/README.md，提交 96b9cdb

工具

184

apple_get_preferences

Apple Get Preferences

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

無需輸入參數。

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.

輸入參數probe_apps

apple_update_preferences

Apple Update Preferences

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

輸入參數default_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 個

apple_detect_digest_folder

Apple Detect Digest Folder

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

無需輸入參數。

apple_set_digest_folder

Apple Set Digest Folder

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

輸入參數folder_id必填folder_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.

輸入參數folder_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.

輸入參數contact_id必填clear_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.

輸入參數recipient必填preferred_channel

apple_preview_communication

Apple Preview Communication

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

輸入參數message必填subjectrecipient必填attachmentsfrom_accountpreferred_channel

apple_preview_archive_message

Apple Preview Archive Message

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

輸入參數message_id必填archive_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.

輸入參數notestitle必填list_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.

輸入參數tagstitle必填body_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.

輸入參數due_datemessage_id必填note_titlecreate_notereminder_titlecreate_reminder

apple_send_communication

Apple Send Communication

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

輸入參數message必填subjectrecipient必填attachmentsfrom_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.

輸入參數message_id必填archive_accountarchive_mailbox

apple_list_recent_actions

Apple List Recent Actions

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

輸入參數limit

apple_undo_action

Apple Undo Action

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

輸入參數action_id必填

apple_create_reminder_with_defaults

Apple Create Reminder With Defaults

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

輸入參數notestitle必填list_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.

輸入參數tagstitle必填body_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.

輸入參數due_datemessage_id必填note_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.

輸入參數event_id必填

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.

輸入參數limitquery必填

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.

輸入參數origin必填transportdestination必填

apple_find_duplicate_contacts

Apple Find Duplicate Contacts

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

輸入參數querymerge_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.

輸入參數query必填

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.

輸入參數limitquery必填

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.

輸入參數dry_runrequest必填input_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.

輸入參數bundle_idapplication

apple_get_focus_status

Apple Get Focus Status

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

無需輸入參數。

apple_get_system_context

Apple Get System Context

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

無需輸入參數。

apple_open_file_path

Apple Open File Path

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

輸入參數path必填

apple_reveal_in_finder

Apple Reveal In Finder

Reveal a file or folder in Finder through Apple Files.

輸入參數path必填

apple_tag_file

Apple Tag File

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

輸入參數path必填tagsaction

apple_update_system_setting

Apple Update System Setting

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

輸入參數modeenabledsetting必填

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.

輸入參數keytextindexlabelvalueaction必填bundle_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.

輸入參數limitquery

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.

輸入參數limitquery

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.

輸入參數limitquery

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.

輸入參數limitquery

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.

輸入參數limitquery

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.

輸入參數limitquery

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.

輸入參數limitquery

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.

輸入參數limitquery

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.

輸入參數limitquery

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.

輸入參數limitquery

apple_permission_guide

Apple Permission Guide

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

輸入參數domain

apple_recheck_permissions

Apple Recheck Permissions

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

無需輸入參數。

apple_send_message_interactive

Apple Send Message Interactive

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

輸入參數textrecipient

apple_create_event_interactive

Apple Create Event Interactive

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

輸入參數notestitleall_dayend_isolocationstart_isocalendar_id

apple_health

Apple Health

Report aggregated health across the unified Apple ecosystem MCP domains.

無需輸入參數。

apple_overview

Apple Overview

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

無需輸入參數。

apple_generate_daily_briefing

Apple Generate Daily Briefing

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

輸入參數mail_limitmail_query

apple_generate_weekly_briefing

Apple Generate Weekly Briefing

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

輸入參數daysmail_limitmail_query

apple_triage_communications_task

Apple Triage Communications Task

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

輸入參數mail_limitmail_queryconversation_limit

mail_health

Mail Health

Report the active Apple Mail MCP configuration.

無需輸入參數。

mail_list_mailboxes

List Mailboxes

List Apple Mail mailboxes, optionally filtered by account.

輸入參數account

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.

輸入參數limitquery必填accountmailboxunread_only

mail_get_message

Get Email

Fetch a single Apple Mail message by message_id.

輸入參數message_id必填

mail_get_thread

Get Thread

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

輸入參數limitmessage_id必填

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.

輸入參數ccto必填bccbodysubjectattachmentsfrom_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).

輸入參數body必填reply_allmessage_id必填from_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).

輸入參數body必填limitreply_allmessage_id必填from_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).

輸入參數to必填bodymessage_id必填from_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.

輸入參數is_read必填message_id必填

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.

輸入參數message_id必填target_accounttarget_mailbox必填

mail_archive_thread

Archive Thread

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

輸入參數limitmessage_id必填archive_accountarchive_mailbox

mail_delete_message

Delete Message

Delete (trash) an email message by its message_id.

輸入參數message_id必填

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.

輸入參數ccto必填bccbodysubjectattachmentsfrom_account

calendar_health

Calendar Health

Report the active Apple Calendar server configuration.

無需輸入參數。

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.

無需輸入參數。

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.

輸入參數limitend_iso必填start_iso必填calendar_id

calendar_get_event

Get Event

Fetch full details for a calendar event by event_id.

輸入參數event_id必填

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.

輸入參數notestitle必填alarmsall_dayend_iso必填locationstart_iso必填recurrencecalendar_id必填

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.

輸入參數notesscopetitlealarmsall_dayend_isoevent_id必填locationstart_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.

輸入參數scopeevent_id必填occurrence_start_iso

reminders_health

Reminders Health

Report the active Apple Reminders MCP server configuration.

無需輸入參數。

reminders_list_lists

List Reminder Lists

List available Apple Reminders lists.

無需輸入參數。

reminders_create_list

Create Reminder List

Create a new Apple Reminders list.

輸入參數title必填

reminders_delete_list

Delete Reminder List

Delete a reminder list entirely. Requires full_access safety mode.

輸入參數list_id必填

reminders_list_reminders

List Reminders

List reminders with optional list and due-date filters.

輸入參數limitsearchlist_iddue_afterdue_beforeinclude_completed

reminders_get_reminder

Get Reminder

Fetch full details for a reminder by reminder_id.

輸入參數reminder_id必填

reminders_create_reminder

Create Reminder

Create a new reminder in a specific Apple Reminders list.

輸入參數tagsnotestitle必填list_id必填due_datepriorityremind_atdue_all_dayparent_reminder_id

reminders_update_reminder

Update Reminder

Update one or more fields on an existing reminder.

輸入參數tagsnotestitlelist_iddue_datepriorityremind_atdue_all_dayreminder_id必填parent_reminder_id

reminders_complete_reminder

Complete Reminder

Mark a reminder as completed.

輸入參數reminder_id必填

reminders_uncomplete_reminder

Uncomplete Reminder

Mark a reminder as not completed.

輸入參數reminder_id必填

reminders_delete_reminder

Delete Reminder

Delete a reminder by reminder_id.

輸入參數reminder_id必填

shortcuts_health

Shortcuts Health

Report the active Apple Shortcuts MCP configuration.

無需輸入參數。

shortcuts_list_shortcuts

List Shortcuts

List Apple Shortcuts, optionally restricted to one folder.

輸入參數folder_name

shortcuts_list_folders

List Shortcut Folders

List Apple Shortcuts folders.

無需輸入參數。

shortcuts_view_shortcut

View Shortcut

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

輸入參數shortcut_name_or_identifier必填

shortcuts_run_shortcut

Run Shortcut

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

輸入參數input_textinput_pathsoutput_pathoutput_typeshortcut_name_or_identifier必填

files_health

Files Health

Report the active Apple Files MCP configuration.

無需輸入參數。

files_list_allowed_roots

List Allowed Roots

List the file system roots the server may access.

無需輸入參數。

files_list_directory

List Directory

List files and folders inside an allowed directory path.

輸入參數path必填

files_search_files

Search Files

Search file and folder names inside the allowed roots.

輸入參數limitquery必填base_path

files_get_file_info

Get File Info

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

輸入參數path必填

files_read_text_file

Read Text File

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

輸入參數path必填max_bytes

files_recent_files

Recent Files

List recently modified files inside the allowed roots.

輸入參數limit

files_get_tags

Get Tags

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

輸入參數path必填

files_list_recent_locations

List Recent Locations

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

輸入參數limit

files_get_icloud_status

Get iCloud Status

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

無需輸入參數。

files_create_folder

Create Folder

Create a folder inside the allowed roots.

輸入參數path必填

files_move_path

Move Path

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

輸入參數source必填destination必填

files_open_path

Open Path

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

輸入參數path必填

files_reveal_in_finder

Reveal In Finder

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

輸入參數path必填

files_set_tags

Set Tags

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

輸入參數path必填tags必填

files_add_tags

Add Tags

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

輸入參數path必填tags必填

files_remove_tags

Remove Tags

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

輸入參數path必填tags必填

files_delete_path

Delete Path

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

輸入參數path必填

system_health

System Health

Report the active Apple System MCP configuration.

無需輸入參數。

system_status

System Status

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

無需輸入參數。

system_get_battery

Get Battery

Get the current battery state from macOS.

無需輸入參數。

system_get_frontmost_app

Get Frontmost App

Get the name of the current frontmost application.

無需輸入參數。

system_list_running_apps

List Running Apps

List currently running foreground applications.

無需輸入參數。

system_get_clipboard

Get Clipboard

Read the current text clipboard contents.

無需輸入參數。

system_list_settings_domains

List Settings Domains

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

無需輸入參數。

system_get_appearance_settings

Get Appearance Settings

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

無需輸入參數。

system_get_accessibility_settings

Get Accessibility Settings

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

無需輸入參數。

system_get_dock_settings

Get Dock Settings

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

無需輸入參數。

system_get_finder_settings

Get Finder Settings

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

無需輸入參數。

system_get_settings_snapshot

Get Settings Snapshot

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

無需輸入參數。

system_get_focus_status

Get Focus Status

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

無需輸入參數。

system_get_context_snapshot

Get System Context Snapshot

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

無需輸入參數。

system_read_preference_domain

Read Preference Domain

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

輸入參數domain必填current_host

system_set_appearance_mode

Set Appearance Mode

Set macOS appearance mode to light or dark.

輸入參數mode必填

system_set_show_all_extensions

Set Show All Extensions

Show or hide filename extensions in macOS.

輸入參數enabled必填

system_set_show_hidden_files

Set Show Hidden Files

Show or hide hidden files in Finder.

輸入參數enabled必填

system_set_finder_path_bar

Set Finder Path Bar

Show or hide the Finder path bar.

輸入參數enabled必填

system_set_finder_status_bar

Set Finder Status Bar

Show or hide the Finder status bar.

輸入參數enabled必填

system_set_dock_autohide

Set Dock Autohide

Enable or disable Dock autohide.

輸入參數enabled必填

system_set_dock_show_recents

Set Dock Show Recents

Enable or disable recent applications in the Dock.

輸入參數enabled必填

system_set_reduce_motion

Set Reduce Motion

Enable or disable macOS reduce motion accessibility mode.

輸入參數enabled必填

system_set_increase_contrast

Set Increase Contrast

Enable or disable macOS increase contrast accessibility mode.

輸入參數enabled必填

system_set_reduce_transparency

Set Reduce Transparency

Enable or disable macOS reduce transparency accessibility mode.

輸入參數enabled必填

system_set_clipboard

Set Clipboard

Write text into the macOS clipboard.

輸入參數text必填

system_show_notification

Show Notification

Display a local macOS notification.

輸入參數body必填title必填subtitle

system_open_application

Open Application

Open an application by name using macOS.

輸入參數bundle_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.

輸入參數bundle_idmenu_path必填application

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.

輸入參數key必填bundle_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.

輸入參數text必填bundle_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.

輸入參數indexlabelbundle_idapplicationdescription

maps_health

Maps Health

Report the active Apple Maps MCP configuration.

無需輸入參數。

maps_search_places

Search Places

Search Apple Maps for matching places.

輸入參數limitquery必填

maps_get_directions

Get Directions

Get Apple Maps route details between an origin and destination.

輸入參數origin必填transportdestination必填

maps_build_maps_link

Build Maps Link

Build an Apple Maps URL for a destination or route.

輸入參數origintransportdestination必填

maps_open_directions_in_maps

Open Directions In Maps

Open directions in the Apple Maps app.

輸入參數origintransportdestination必填

contacts_health

Contacts Health

Report the active Apple Contacts MCP configuration.

無需輸入參數。

contacts_list_contacts

List Contacts

List Apple Contacts entries.

輸入參數limitoffset

contacts_create_contact

Create Contact

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

輸入參數noteemailsphoneslast_namefirst_name必填organization

contacts_update_contact

Update Contact

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

輸入參數noteemailsphoneslast_namecontact_id必填first_nameorganization

contacts_delete_contact

Delete Contact

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

輸入參數contact_id必填

contacts_search_contacts

Search Contacts

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

輸入參數limitquery必填

contacts_get_contact

Get Contact

Fetch full details for an Apple Contacts record by contact_id.

輸入參數contact_id必填

contacts_resolve_message_recipient

Resolve Message Recipient

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

輸入參數query必填channel

notes_health

Notes Health

Report the active Apple Notes MCP configuration.

無需輸入參數。

notes_list_accounts

List Accounts

List Apple Notes accounts.

無需輸入參數。

notes_list_folders

List Folders

List Apple Notes folders.

輸入參數limitoffsetaccount_name

notes_list_notes

List Notes

List notes, optionally scoped to a folder or account.

輸入參數limitoffsetfolder_idaccount_name

notes_get_note

Get Note

Fetch full details for an Apple Notes note by note_id.

輸入參數note_id必填

notes_search_notes

Search Notes

Search notes by text, folder, or account.

輸入參數limitquery必填offsetfolder_idaccount_name

notes_create_note

Create Note

Create a new note in a folder.

輸入參數tagstitle必填body_htmlfolder_id必填

notes_append_to_note

Append to Note

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

輸入參數body必填note_id必填

notes_update_note

Update Note

Update an existing note.

輸入參數tagstitlenote_id必填body_htmlfolder_id

notes_delete_note

Delete Note

Delete a note by note_id.

輸入參數note_id必填

notes_move_note

Move Note

Move a note to a different folder.

輸入參數note_id必填folder_id必填

notes_create_folder

Create Notes Folder

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

輸入參數folder_name必填account_name必填parent_folder_id

notes_rename_folder

Rename Folder

Rename an existing folder.

輸入參數folder_id必填folder_name必填

notes_delete_folder

Delete Folder

Delete an Apple Notes folder.

輸入參數folder_id必填

notes_list_attachments

List Note Attachments

List attachments for a note.

輸入參數note_id必填

messages_health

Messages Health

Report Messages server configuration and capability status.

無需輸入參數。

messages_list_conversations

List Conversations

List recent Apple Messages conversations.

輸入參數limitoffsetunread_only

messages_get_conversation

Get Conversation

Fetch a single Apple Messages conversation with paginated messages.

輸入參數limitoffsetchat_id必填

messages_search_messages

Search Messages

Search Apple Messages text history.

輸入參數limitquery必填offsetsenderchat_idend_isostart_iso

messages_get_message

Get Message

Fetch a single Apple Messages message by message_id.

輸入參數message_id必填

messages_list_attachments

List Message Attachments

List Apple Messages attachments by chat or message.

輸入參數limitoffsetchat_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.

輸入參數text必填recipient必填service_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.

輸入參數text必填chat_id必填service_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.

輸入參數textfile_path必填recipient必填service_name