Apple Tools (Unified) MCP Server

Name: Apple Tools (Unified) MCP Server
Author: io.github.JonathanRReed

io.github.JonathanRReed/apple-tools-mcp

Repository Registry

What is the Apple Tools (Unified) MCP server?

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

How to install Apple Tools (Unified)

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "apple-tools-mcp": {
      "command": "uvx",
      "args": [
        "apple-tools-mcp"
      ],
      "env": {
        "APPLE_MAIL_MCP_SAFETY_PROFILE": "<YOUR_APPLE_MAIL_MCP_SAFETY_PROFILE>",
        "APPLE_CALENDAR_MCP_SAFETY_MODE": "<YOUR_APPLE_CALENDAR_MCP_SAFETY_MODE>",
        "APPLE_REMINDERS_MCP_SAFETY_MODE": "<YOUR_APPLE_REMINDERS_MCP_SAFETY_MODE>",
        "APPLE_FILES_MCP_SAFETY_MODE": "<YOUR_APPLE_FILES_MCP_SAFETY_MODE>",
        "APPLE_FILES_MCP_ALLOWED_ROOTS": "<YOUR_APPLE_FILES_MCP_ALLOWED_ROOTS>",
        "APPLE_SYSTEM_MCP_SAFETY_MODE": "<YOUR_APPLE_SYSTEM_MCP_SAFETY_MODE>",
        "APPLE_CONTACTS_MCP_SAFETY_MODE": "<YOUR_APPLE_CONTACTS_MCP_SAFETY_MODE>",
        "APPLE_NOTES_MCP_SAFETY_MODE": "<YOUR_APPLE_NOTES_MCP_SAFETY_MODE>",
        "APPLE_MESSAGES_MCP_SAFETY_MODE": "<YOUR_APPLE_MESSAGES_MCP_SAFETY_MODE>",
        "APPLE_SHORTCUTS_MCP_SAFETY_MODE": "<YOUR_APPLE_SHORTCUTS_MCP_SAFETY_MODE>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "apple-tools-mcp": {
      "command": "uvx",
      "args": [
        "apple-tools-mcp"
      ],
      "env": {
        "APPLE_MAIL_MCP_SAFETY_PROFILE": "<YOUR_APPLE_MAIL_MCP_SAFETY_PROFILE>",
        "APPLE_CALENDAR_MCP_SAFETY_MODE": "<YOUR_APPLE_CALENDAR_MCP_SAFETY_MODE>",
        "APPLE_REMINDERS_MCP_SAFETY_MODE": "<YOUR_APPLE_REMINDERS_MCP_SAFETY_MODE>",
        "APPLE_FILES_MCP_SAFETY_MODE": "<YOUR_APPLE_FILES_MCP_SAFETY_MODE>",
        "APPLE_FILES_MCP_ALLOWED_ROOTS": "<YOUR_APPLE_FILES_MCP_ALLOWED_ROOTS>",
        "APPLE_SYSTEM_MCP_SAFETY_MODE": "<YOUR_APPLE_SYSTEM_MCP_SAFETY_MODE>",
        "APPLE_CONTACTS_MCP_SAFETY_MODE": "<YOUR_APPLE_CONTACTS_MCP_SAFETY_MODE>",
        "APPLE_NOTES_MCP_SAFETY_MODE": "<YOUR_APPLE_NOTES_MCP_SAFETY_MODE>",
        "APPLE_MESSAGES_MCP_SAFETY_MODE": "<YOUR_APPLE_MESSAGES_MCP_SAFETY_MODE>",
        "APPLE_SHORTCUTS_MCP_SAFETY_MODE": "<YOUR_APPLE_SHORTCUTS_MCP_SAFETY_MODE>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "apple-tools-mcp": {
      "command": "uvx",
      "args": [
        "apple-tools-mcp"
      ],
      "env": {
        "APPLE_MAIL_MCP_SAFETY_PROFILE": "<YOUR_APPLE_MAIL_MCP_SAFETY_PROFILE>",
        "APPLE_CALENDAR_MCP_SAFETY_MODE": "<YOUR_APPLE_CALENDAR_MCP_SAFETY_MODE>",
        "APPLE_REMINDERS_MCP_SAFETY_MODE": "<YOUR_APPLE_REMINDERS_MCP_SAFETY_MODE>",
        "APPLE_FILES_MCP_SAFETY_MODE": "<YOUR_APPLE_FILES_MCP_SAFETY_MODE>",
        "APPLE_FILES_MCP_ALLOWED_ROOTS": "<YOUR_APPLE_FILES_MCP_ALLOWED_ROOTS>",
        "APPLE_SYSTEM_MCP_SAFETY_MODE": "<YOUR_APPLE_SYSTEM_MCP_SAFETY_MODE>",
        "APPLE_CONTACTS_MCP_SAFETY_MODE": "<YOUR_APPLE_CONTACTS_MCP_SAFETY_MODE>",
        "APPLE_NOTES_MCP_SAFETY_MODE": "<YOUR_APPLE_NOTES_MCP_SAFETY_MODE>",
        "APPLE_MESSAGES_MCP_SAFETY_MODE": "<YOUR_APPLE_MESSAGES_MCP_SAFETY_MODE>",
        "APPLE_SHORTCUTS_MCP_SAFETY_MODE": "<YOUR_APPLE_SHORTCUTS_MCP_SAFETY_MODE>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "apple-tools-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "apple-tools-mcp"
      ],
      "env": {
        "APPLE_MAIL_MCP_SAFETY_PROFILE": "<YOUR_APPLE_MAIL_MCP_SAFETY_PROFILE>",
        "APPLE_CALENDAR_MCP_SAFETY_MODE": "<YOUR_APPLE_CALENDAR_MCP_SAFETY_MODE>",
        "APPLE_REMINDERS_MCP_SAFETY_MODE": "<YOUR_APPLE_REMINDERS_MCP_SAFETY_MODE>",
        "APPLE_FILES_MCP_SAFETY_MODE": "<YOUR_APPLE_FILES_MCP_SAFETY_MODE>",
        "APPLE_FILES_MCP_ALLOWED_ROOTS": "<YOUR_APPLE_FILES_MCP_ALLOWED_ROOTS>",
        "APPLE_SYSTEM_MCP_SAFETY_MODE": "<YOUR_APPLE_SYSTEM_MCP_SAFETY_MODE>",
        "APPLE_CONTACTS_MCP_SAFETY_MODE": "<YOUR_APPLE_CONTACTS_MCP_SAFETY_MODE>",
        "APPLE_NOTES_MCP_SAFETY_MODE": "<YOUR_APPLE_NOTES_MCP_SAFETY_MODE>",
        "APPLE_MESSAGES_MCP_SAFETY_MODE": "<YOUR_APPLE_MESSAGES_MCP_SAFETY_MODE>",
        "APPLE_SHORTCUTS_MCP_SAFETY_MODE": "<YOUR_APPLE_SHORTCUTS_MCP_SAFETY_MODE>"
      }
    }
  }
}

Claude Code

claude mcp add apple-tools-mcp --env APPLE_MAIL_MCP_SAFETY_PROFILE=<YOUR_APPLE_MAIL_MCP_SAFETY_PROFILE> --env APPLE_CALENDAR_MCP_SAFETY_MODE=<YOUR_APPLE_CALENDAR_MCP_SAFETY_MODE> --env APPLE_REMINDERS_MCP_SAFETY_MODE=<YOUR_APPLE_REMINDERS_MCP_SAFETY_MODE> --env APPLE_FILES_MCP_SAFETY_MODE=<YOUR_APPLE_FILES_MCP_SAFETY_MODE> --env APPLE_FILES_MCP_ALLOWED_ROOTS=<YOUR_APPLE_FILES_MCP_ALLOWED_ROOTS> --env APPLE_SYSTEM_MCP_SAFETY_MODE=<YOUR_APPLE_SYSTEM_MCP_SAFETY_MODE> --env APPLE_CONTACTS_MCP_SAFETY_MODE=<YOUR_APPLE_CONTACTS_MCP_SAFETY_MODE> --env APPLE_NOTES_MCP_SAFETY_MODE=<YOUR_APPLE_NOTES_MCP_SAFETY_MODE> --env APPLE_MESSAGES_MCP_SAFETY_MODE=<YOUR_APPLE_MESSAGES_MCP_SAFETY_MODE> --env APPLE_SHORTCUTS_MCP_SAFETY_MODE=<YOUR_APPLE_SHORTCUTS_MCP_SAFETY_MODE> -- uvx apple-tools-mcp