my-apple-remembers MCP Server

Use This MCP server To

Recall notes and calendar events from Apple Notes on macOS Save important information to Apple Notes for AI memory persistence Access messages and files stored on a Mac via AppleScript Create a personal AI memory system using Apple Notes integration Enable remote memory management by enabling Remote Login on Mac Use natural language prompts to control memory saving and recall Integrate macOS personal data into AI workflows via MCP

README

MCP Server - My Apple Remembers

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.

my-apple-remembers FAQ

How do I set up My Apple Remembers on my Mac?

Enable Remote Login on your macOS device and run the MCP server with minimal configuration.

Is My Apple Remembers compatible with all macOS versions?

Yes, it supports all macOS versions with minimal setup required.

What types of data can My Apple Remembers access and save?

It can recall and save notes, calendar events, messages, and files using Apple Notes.

How does My Apple Remembers interact with Apple Notes?

It uses AppleScript commands to read from and write to Apple Notes for memory persistence.

Can I control how memories are saved or recalled?

Yes, you can use natural language prompts to instruct how and where to save or recall memories.

Is My Apple Remembers secure to use?

It relies on macOS Remote Login security and Apple Notes permissions, ensuring scoped and secure access.

Can this MCP server work with different LLM providers?

Yes, it is provider-agnostic and can integrate with models like OpenAI, Claude, and Gemini.

What is the minimal setup required to start using this server?

Simply enable Remote Login on your Mac and deploy the MCP server container or binary.