My Apple Remembers

A lightweight MCP server that integrates with Apple Notes to create a personal memory system for AI. Easily recall and save information from your Mac using simple AppleScript commands. Compatible with all macOS versions with minimal setup requirements.

python

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "honeybluesky-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"
      ],
      "env": {
        "MACOS_HOST": "localhost",
        "MACOS_PASSWORD": "your_macos_password",
        "MACOS_USERNAME": "your_macos_username"
      }
    }
  }
}

You run an MCP server that can recall and save memories from your macOS environment by interfacing with Apple Notes, Calendars, messages, and files. This server enables you to securely access and persist memories from a remote Mac using a simple Docker-based setup, making it easy to caputure and retrieve important notes and data for future reference.

How to use

To use the My Apple Remembers MCP server, you will run it via Docker and connect an MCP client to the local container. The server expects you to provide credentials for the target Mac and will containerize the remote access flow so your client can instruct it to recall or save memories.

How to install

Prerequisites you need before starting are:

Docker Desktop installed on your machine
Access to the target macOS system with SSH and remote login enabled
An MCP client configured to talk to this server (for example, Claude Desktop or another MCP client)

Step-by-step commands you should run:

Ensure Docker is installed and running on your machine
Start the MCP server using the exact command snippet shown below (replace placeholders with your actual values):

docker 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

Additional setup and configuration

Environment variables shown in the runtime command are required to connect to the remote macOS host and authenticate the session. You can replace the placeholder values with your real credentials when you deploy the server.

Tool capabilities include recalling memories from Apple Notes, Calendar events, iMessages, chat history, and files, as well as saving memories back to Apple Notes for persistent storage.

Security and notes

Use secure, authenticated connections when accessing the remote macOS machine. Only deploy this server in environments where you have explicit permission to access the target Mac and its data.

References to tools and capabilities

Tools available with this MCP server include:

my_apple_recall_memory: Run AppleScript commands on the remote macOS system to recall memories such as Apple Notes, Calendar events, iMessages, chat history, and files.
my_apple_save_memory: Run AppleScript commands on the remote macOS system to save important information to Apple Notes for future reference.

Available tools

my_apple_recall_memory

Run AppleScript commands on a remote macOS system to recall memories from 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 to Apple Notes for future reference.

Built by

VeilStrat

AI signals for GTM teams