my apple remembers

Local 2025-09-01 00:22:09 0

Knowledge And Memory @baryhuang/my-apple-remembers

A simple MCP server that recalls and saves memories from and to Apple Notes.

A simple MCP server that recalls and saves memories from and to 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: Just enable Remote Login on the target Mac
Universal Compatibility: Works with all macOS versions

Control in your hand

You can use prompt to instruct how you want your memory to be save. For example:

You should always use Folder "baryhuang" on recall and save memory.

Installation

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"
      ]
    }
  }
}

Developer Instructions

Clone the repo

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

Building the Docker Image

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

Publishing Multi-Platform Docker Images

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

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

Tools Specifications

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 history, files, and other information on your 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, with host and password.

Security Note

Always use secure, authenticated connections when accessing remote macOS machines. This tool should only be used with servers you trust and have permission to access.

License

See the LICENSE file for details.

[
  {
    "description": "Run Apple Script on a remote MacOs machine. This call should be used to recall the apple notes, apple calendar, imessages, chat messages, files, context or any other information of a MacOs machine can have access to.",
    "inputSchema": {
      "properties": {
        "code_snippet": {
          "description": "AppleScript code to execute on the remote machine. Can be a single line or multi-line script. You should prefer multi-line scripts for complex operations.",
          "type": "string"
        },
        "timeout": {
          "description": "Command execution timeout in seconds (default: 60)",
          "type": "integer"
        }
      },
      "required": [
        "code_snippet"
      ],
      "type": "object"
    },
    "name": "my_apple_recall_memory"
  },
  {
    "description": "Run Apple Script on a remote MacOs machine. This call should be used to save relevant information to the apple notes. You decide what information to save. You should always add a new notes with a timestamp as the title.",
    "inputSchema": {
      "properties": {
        "code_snippet": {
          "description": "AppleScript code to execute on the remote machine. Can be a single line or multi-line script. You should prefer multi-line scripts for complex operations.",
          "type": "string"
        },
        "timeout": {
          "description": "Command execution timeout in seconds (default: 60)",
          "type": "integer"
        }
      },
      "required": [
        "code_snippet"
      ],
      "type": "object"
    },
    "name": "my_apple_save_memory"
  }
]