Apple Tools (Unified)
Single MCP server bundling Apple Mail, Calendar, Notes, Files, Messages and Maps on macOS
- Pricing
- Open source
- Platforms
- macOS, CLI
- Runs
- Locally
- Version
- 1.1.7
- Listing updated
- today
Similar MCP servers
About Apple Tools (Unified)
Apple Tools (Unified) is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
Rather than wiring ten separate servers, this one entrypoint wraps the standalone Apple servers for Mail, Calendar, Reminders, Messages, Contacts, Notes, Shortcuts, Files, System and Maps. Its added value is cross-app work: daily and weekly briefings, communications triage, meeting prep, follow-up capture, and routing a message by mail or Messages according to saved defaults and per-contact preferences.
Actions that change things can be previewed, audited and undone. File access is limited to configured roots, and each domain has its own safety mode with safe_manage as the usual default, so replies and forwards are saved as drafts unless Mail is set to full_access. A bounded GUI fallback exists for tasks a native app domain cannot finish. Messages responses carry contact names when Contacts access is already granted and explain why names are missing otherwise.
Tool discovery uses search_tools and get_tool_info for clients that cannot load a large tool list. It needs macOS, Python 3.11+ when run from a clone, and the matching macOS permissions per app.
Install
Run in a terminal
claude mcp add apple-tools-mcp -- uvx apple-tools-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"apple-tools-mcp": {
"command": "uvx",
"args": [
"apple-tools-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"apple-tools-mcp": {
"command": "uvx",
"args": [
"apple-tools-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"apple-tools-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"apple-tools-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"apple-tools-mcp": {
"command": "uvx",
"args": [
"apple-tools-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"apple-tools-mcp": {
"command": "uvx",
"args": [
"apple-tools-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
APPLE_MAIL_MCP_SAFETY_PROFILESafety mode for the Mail domain: safe_readonly, safe_manage, or full_access.APPLE_CALENDAR_MCP_SAFETY_MODESafety mode for the Calendar domain: safe_readonly, safe_manage, or full_access.APPLE_REMINDERS_MCP_SAFETY_MODESafety mode for the Reminders domain: safe_readonly, safe_manage, or full_access.APPLE_FILES_MCP_SAFETY_MODESafety mode for the Files domain: safe_readonly, safe_manage, or full_access.APPLE_FILES_MCP_ALLOWED_ROOTSComma-separated directories file tools may access. Defaults to Desktop, Documents, Downloads, and iCloud Drive.APPLE_SYSTEM_MCP_SAFETY_MODESafety mode for the System domain: safe_readonly, safe_manage, or full_access.APPLE_SYSTEM_MCP_GUI_ALLOWED_APPSComma-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_MODESafety mode for the Contacts domain: safe_readonly, safe_manage, or full_access.APPLE_NOTES_MCP_SAFETY_MODESafety mode for the Notes domain: safe_readonly, safe_manage, or full_access.APPLE_MESSAGES_MCP_SAFETY_MODESafety mode for the Messages domain: safe_readonly, safe_manage, or full_access.APPLE_SHORTCUTS_MCP_SAFETY_MODESafety mode for the Shortcuts domain: safe_readonly, safe_manage, or full_access.APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOTDirectory containing files that Mail may attach. Unset disables attachments.APPLE_SHORTCUTS_MCP_ALLOWED_ROOTSComma-separated folders shortcuts_run_shortcut may write output to. Unset uses the Files folders.APPLE_MESSAGES_MCP_ALLOWED_ROOTSComma-separated folders messages_send_attachment may send files from. Unset uses the Files folders.
Tools this server provides (11)
Taken from the project documentation; the running server may differ.
- search_tools
- Finds tools by name, alias or domain tag.
- get_tool_info
- Loads the full schema and examples for one tool.
- apple_list_prompts
- Lists prompts as a fallback for clients without prompt support.
- apple_get_prompt
- Fetches one prompt.
- apple_health
- Reports health without requesting permissions.
- apple_permission_guide
- Explains macOS permissions needed.
- apple_recheck_permissions
- Rechecks permissions.
- apple_overview
- Returns an overview without probing apps.
- apple_detect_defaults
- Returns or discovers saved default targets.
- apple_get_preferences
- Reads saved preferences.
- apple_update_preferences
- Updates saved preferences.
What it does
- Ten Apple domains
- Mail, Calendar, Reminders, Messages, Contacts, Notes, Shortcuts, Files, System and Maps.
- Briefing tools
- Daily, weekly and communications-triage briefings.
- Saved defaults
- Default accounts, folders and preferred channel, plus per-contact overrides.
- Preview, audit, undo
- Reversible actions can be previewed, listed and undone.
- Scoped file roots
- File access is limited to configured folders.
- Per-domain safety modes
- Each app has its own read-only, manage or full access setting.
Good for
- Prepare a daily briefing across mail and calendar
- Triage messages and mail in one pass
- Capture a follow-up as a reminder and note
- Plan travel using Maps route estimates
- Undo a recent assistant action
Pricing
Open source
Apple Tools (Unified) FAQ
How do I install it?
Run uvx apple-tools-mcp on a Mac.
Will it send email on its own?
Not by default; replies and forwards become drafts unless Mail is set to full_access.
Can I limit file access?
Yes, with APPLE_FILES_MCP_ALLOWED_ROOTS.
Does the overview request permissions?
No. apple_health, apple_recheck_permissions and apple_overview do not send Apple Events or request new permissions.
Can I use one app only?
Yes, standalone servers exist for each app.
Is Apple Tools (Unified) free?
Yes. Apple Tools (Unified) is open source, so you can use and self-host it for free.
How do I add Apple Tools (Unified) to Claude Code?
Run this command in your terminal: claude mcp add apple-tools-mcp -- uvx apple-tools-mcp
What are the best alternatives to Apple Tools (Unified)?
The closest alternatives to Apple Tools (Unified) are Ha MCP, Concord MCP, note1, InviteKit Calendar Files and Google Workspace MCP.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
