MCP Server - 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.
What is My Apple Remembers?
My Apple Remembers is a lightweight MCP server that integrates with Apple Notes to create a personal memory system for AI, allowing users to easily recall and save information from their Mac using simple AppleScript commands.
How to use My Apple Remembers?
To use My Apple Remembers, enable SSH on your macOS, install Docker Desktop, and configure the MCP server with your macOS credentials. You can then use prompts to instruct how you want your memory to be saved and recalled.
Key features of My Apple Remembers?
- 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.
Use cases of My Apple Remembers?
- Recalling important notes and calendar events.
- Saving messages and files for future reference.
- Integrating with AI systems to enhance memory management.
FAQ from My Apple Remembers?
- Can I use My Apple Remembers on any macOS version?
Yes! It is compatible with all macOS versions.
- Is there a setup guide available?
Yes! Detailed installation and configuration instructions are provided in the documentation.
- What security measures should I take?
Always use secure, authenticated connections when accessing remote macOS machines.
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.
