Skip to content
MCP server

Apple Tools (Unified)

Single MCP server bundling Apple Mail, Calendar, Notes, Files, Messages and Maps on macOS

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "apple-tools-mcp": {
      "command": "uvx",
      "args": [
        "apple-tools-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "apple-tools-mcp": {
      "command": "uvx",
      "args": [
        "apple-tools-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers