Skip to content
VS Code

Apple Tools (Unified) for VS Code

io.github.jonathanrreed/apple-tools-mcp

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

client:VS Code transport:stdio runtime:pypi

Install Apple Tools (Unified) in VS Code

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apple-mail-mcp-safety-profile",
      "description": "APPLE_MAIL_MCP_SAFETY_PROFILE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "apple-calendar-mcp-safety-mode",
      "description": "APPLE_CALENDAR_MCP_SAFETY_MODE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "apple-reminders-mcp-safety-mode",
      "description": "APPLE_REMINDERS_MCP_SAFETY_MODE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "apple-files-mcp-safety-mode",
      "description": "APPLE_FILES_MCP_SAFETY_MODE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "apple-files-mcp-allowed-roots",
      "description": "APPLE_FILES_MCP_ALLOWED_ROOTS",
      "password": true
    },
    {
      "type": "promptString",
      "id": "apple-system-mcp-safety-mode",
      "description": "APPLE_SYSTEM_MCP_SAFETY_MODE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "apple-contacts-mcp-safety-mode",
      "description": "APPLE_CONTACTS_MCP_SAFETY_MODE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "apple-notes-mcp-safety-mode",
      "description": "APPLE_NOTES_MCP_SAFETY_MODE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "apple-messages-mcp-safety-mode",
      "description": "APPLE_MESSAGES_MCP_SAFETY_MODE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "apple-shortcuts-mcp-safety-mode",
      "description": "APPLE_SHORTCUTS_MCP_SAFETY_MODE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "apple-mail-mcp-allowed-attachment-root",
      "description": "APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT",
      "password": true
    }
  ],
  "servers": {
    "apple-tools-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "apple-tools-mcp"
      ],
      "env": {
        "APPLE_MAIL_MCP_SAFETY_PROFILE": "${input:apple-mail-mcp-safety-profile}",
        "APPLE_CALENDAR_MCP_SAFETY_MODE": "${input:apple-calendar-mcp-safety-mode}",
        "APPLE_REMINDERS_MCP_SAFETY_MODE": "${input:apple-reminders-mcp-safety-mode}",
        "APPLE_FILES_MCP_SAFETY_MODE": "${input:apple-files-mcp-safety-mode}",
        "APPLE_FILES_MCP_ALLOWED_ROOTS": "${input:apple-files-mcp-allowed-roots}",
        "APPLE_SYSTEM_MCP_SAFETY_MODE": "${input:apple-system-mcp-safety-mode}",
        "APPLE_CONTACTS_MCP_SAFETY_MODE": "${input:apple-contacts-mcp-safety-mode}",
        "APPLE_NOTES_MCP_SAFETY_MODE": "${input:apple-notes-mcp-safety-mode}",
        "APPLE_MESSAGES_MCP_SAFETY_MODE": "${input:apple-messages-mcp-safety-mode}",
        "APPLE_SHORTCUTS_MCP_SAFETY_MODE": "${input:apple-shortcuts-mcp-safety-mode}",
        "APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT": "${input:apple-mail-mcp-allowed-attachment-root}"
      }
    }
  }
}

VS Code prompts for each input the first time the server starts, so no secret is written to the file. VS Code docs

Apple Tools (Unified) in other clients