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