My Apple Remembers

🚀 MCP Server - My Apple Memories

A simple MCP server for recalling and saving memories from Apple Notes.

✨ Features

• Memory Recall: Access notes, calendar events, messages, files, and other information from your Mac.
• Memory Persistence: Save important information to Apple Notes for future reference.
• Minimal Setup: Only require enabling remote login on the target Mac.
• Universal Compatibility: Compatible with all macOS versions.

💪 Take Control

You can use prompts to indicate how to save your memories. For example:

You should always set the folder for recalling and saving memories as "baryhuang".

📦 Installation

• Enable SSH on macOS
• Install Docker Desktop on your local Mac
• Add this MCP server to Claude Desktop

You can configure Claude Desktop to use the Docker image by adding the following to your Claude configuration:

{
  "mcpServers": {
    "my-apple-remembers": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "MACOS_USERNAME=your_macos_username",
        "-e",
        "MACOS_PASSWORD=your_macos_password",
        "-e",
        "MACOS_HOST=localhost",
        "--rm",
        "buryhuang/mcp-my-apple-remembers:latest"
      ]
    }
  }
}

📚 Documentation

📥 Clone the Repository

# Clone the repository
git clone https://github.com/baryhuang/mcp-my-apple-remembers.git
cd mcp-my-apple-remembers

🛠️ Build the Docker Image

# Build the Docker image
docker build -t mcp-my-apple-remembers .

🚀 Publish Multi-Platform Docker Image

# Set up Docker buildx for multi-platform builds
docker buildx create --use

# Build and push multi-platform images
docker buildx build --platform linux/amd64,linux/arm64 -t buryhuang/mcp-my-apple-remembers:latest --push .

📄 Tool Specification

my_apple_recall_memory

Run AppleScript commands on a remote macOS system to recall memories. This tool helps access Apple Notes, calendar events, iMessages, chat logs, files, and other information on the Mac.

my_apple_save_memory

Run AppleScript commands on a remote macOS system to save important information. This tool allows AI to persist relevant information to Apple Notes for future reference.

All tools require macOS SSH access, including the host and password.

⚠️ Security Considerations

Always use a secure and authenticated connection to access the remote macOS machine. This tool should only be used on servers you trust and have authorization to access.

📄 License

For more details, please refer to the LICENSE file.