APPLE_MAIL_MCP_SAFETY_PROFILE — Safety mode for the Mail domain: safe_readonly, safe_manage, or full_access.
APPLE_CALENDAR_MCP_SAFETY_MODE — Safety mode for the Calendar domain: safe_readonly, safe_manage, or full_access.
APPLE_REMINDERS_MCP_SAFETY_MODE — Safety mode for the Reminders domain: safe_readonly, safe_manage, or full_access.
APPLE_FILES_MCP_SAFETY_MODE — Safety mode for the Files domain: safe_readonly, safe_manage, or full_access.
APPLE_FILES_MCP_ALLOWED_ROOTS — Comma-separated directories file tools may access. Defaults to Desktop, Documents, Downloads, and iCloud Drive.
APPLE_SYSTEM_MCP_SAFETY_MODE — Safety mode for the System domain: safe_readonly, safe_manage, or full_access.
APPLE_SYSTEM_MCP_GUI_ALLOWED_APPS — Comma-separated bundle ids of apps that GUI input tools (type, press keys, click, choose, menu) may send input to, for example com.apple.TextEdit,com.apple.Safari. Unset or empty disables GUI input. Terminals, script editors and automation apps are always refused.
APPLE_CONTACTS_MCP_SAFETY_MODE — Safety mode for the Contacts domain: safe_readonly, safe_manage, or full_access.
APPLE_NOTES_MCP_SAFETY_MODE — Safety mode for the Notes domain: safe_readonly, safe_manage, or full_access.
APPLE_MESSAGES_MCP_SAFETY_MODE — Safety mode for the Messages domain: safe_readonly, safe_manage, or full_access.
APPLE_SHORTCUTS_MCP_SAFETY_MODE — Safety mode for the Shortcuts domain: safe_readonly, safe_manage, or full_access.
APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT — Directory containing files that Mail may attach. Unset disables attachments.
APPLE_SHORTCUTS_MCP_ALLOWED_ROOTS — Comma-separated folders shortcuts_run_shortcut may write output to. Unset uses the Files folders.
APPLE_MESSAGES_MCP_ALLOWED_ROOTS — Comma-separated folders messages_send_attachment may send files from. Unset uses the Files folders.
Claude Code にはローカルコマンド用のインストールリンクがありません。下のコマンドをコピーして、ターミナルで実行してください。
MCP servers that let an AI client use Apple apps and macOS tools. Create reminders, send messages, check calendars, search mail, manage files, and get directions.
The servers run on your Mac. Your MCP client may send returned data to its model provider, and Apple apps may sync through iCloud or another account. Local execution does not mean the data stays local.
Requires Python 3.11+ and macOS. Uses MCP specification and Python SDK 2.x, with support for older client protocol revisions. .
Unified Apple ecosystem MCP server for macOS: Mail, Calendar, Notes, Files, Messages, and more.
Run uvx apple-tools-mcp to start the server directly. Standalone servers use the same approach, such as uvx apple-mcp-mail or uvx apple-calendar-mcp.
Restart your client after installing or upgrading. Call search_tools with calendar health to check discovery without reading app data.
For Claude Desktop, download a server's .mcpb bundle from Releases and double-click it.
Set app-specific safety modes and directories in your client's env settings. An explicitly invalid or blank safety setting selects safe_readonly; unset settings retain each domain's documented default. The configuration guide lists defaults and options. Mail attachments are disabled until you set APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT to a dedicated directory. Files tools only access APPLE_FILES_MCP_ALLOWED_ROOTS; macOS may impose further restrictions.
Choose a server
Start with Apple-Tools-MCP. It combines all ten apps and tools below, plus saved defaults, contact routing, Mail thread helpers, undo, briefings, and cross-app workflows.
Choose a standalone server to expose fewer apps to your client:
No privacy prompt; Swift helper needs Xcode command line tools
maps_health
maps_permission_guide
The unified server uses apple_health, apple_permission_guide, and apple_recheck_permissions. You must approve permissions yourself in the macOS prompt or System Settings.
Find and use tools
MCP tools/list returns each tool's schemas and read or write annotations. Use search_tools to search names, descriptions, and aliases; use get_tool_info for one tool's schema and examples.
Resolve recipients through Contacts before sending, unless you have the exact address. For Mail conversations, use mail_get_thread, mail_reply_latest_in_thread, or mail_archive_thread. Pass an exact sender email in from_account when the sending identity matters.
Mail search requires a query: a sender, subject fragment, or *. Reminders due_date requires a timezone offset, such as yyyy-MM-ddTHH:mm:ss-08:00. Omit service_name when sending iMessages.
The unified server also provides apple_generate_daily_briefing, apple_generate_weekly_briefing, and apple_triage_communications_task. Clients without prompt support can use apple_list_prompts, apple_get_prompt, and their per-server equivalents.
For calls from Python, use the metadata in generated/tool_catalogs/ and wrappers in generated/tool_wrappers/python/. See code-mode.md.
Transport and stored state
stdio is the default. To use Streamable HTTP, set APPLE_<DOMAIN>_MCP_TRANSPORT=streamable-http and the matching _HOST and _PORT variables.
HTTP must bind to 127.0.0.1, ::1, or localhost. The servers have no remote authentication and reject network and wildcard binds. Do not expose them through a tunnel or public proxy.
Apple-Tools-MCP stores defaults in ~/.apple-tools-mcp/preferences.json, configurable through APPLE_AGENT_MCP_STATE_FILE. It stores recent actions in ~/.apple-tools-mcp/actions.json for audit and undo.
Develop
git clone https://github.com/JonathanRReed/Apple-MCPs.git
cd Apple-MCPs
uv sync --all-packages
The uv workspace installs every server into .venv/bin. Each server folder also has a start.sh for clients; it uses uv when available and otherwise creates a virtual environment. Root pyproject.toml defines workspace members, and uv.lock pins dependencies.
npx -y @modelcontextprotocol/[email protected] server --url http://127.0.0.1:8765/mcp --requirements 2026-07-28
Conformance mode registers test fixtures. Use it only for protocol validation. CI runs lint, macOS and Linux tests, generated-file checks, Inspector smoke checks, and conformance tests.