my-apple-remembers

This MCP server provides memory recall and persistence capabilities by interacting with a remote macOS system (Apple Notes, Calendar, Messages, files, and more) through AppleScript commands. Two tools are exposed: my_apple_recall_memory to fetch and recall information from your Mac, and my_apple_save_memory to persist important details to Apple Notes for future reference. To use them, configure Claude Desktop (or your MCP client) to connect to the Docker image and supply macOS SSH credentials. The tools require that SSH access to the target Mac is enabled and that the MACOS_USERNAME, MACOS_PASSWORD, and MACOS_HOST (the remote Mac) are provided in the container environment. Once configured, you can issue prompts that instruct the server what to recall or save, for example: recall recent notes about a project, or save a critical meeting summary to Apple Notes. The server handles the remote execution via AppleScript on the macOS host and returns results back to your session.

Prerequisites:

• Docker installed on the host where you run the MCP server
• Remote macOS machine with SSH access enabled (Remote Login)
• Apple Notes/Calendar/Messages data available on the remote Mac

Installation steps:

1. Ensure Docker is running on your host.
2. Pull the MCP Docker image (optional if using the latest tag via run): docker pull buryhuang/mcp-my-apple-remembers:latest
3. Run the MCP server (using the configuration in mcp_config): 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
4. If integrating with Claude Desktop or another MCP client, add the server under mcpServers with the same docker run command structure as shown in the example configuration.
5. Verify connectivity by sending a test recall or save memory request and confirming results are returned from the remote Mac.

Tips and notes:

• Always secure your macOS SSH credentials. Use strong passwords or SSH keys where possible.
• Ensure MACOS_HOST points to the correct remote Mac accessible from the host running the container.
• The tools rely on AppleScript executed over SSH; if scripts fail, check SSH permissions, firewall, and AppleScript compatibility on the remote Mac.
• This server uses the buryhuang/mcp-my-apple-remembers Docker image; ensure you are using a compatible tag (latest as shown) or a tag you control.
• If you need to customize which data to recall or persist, adjust the prompts sent to the tools (my_apple_recall_memory / my_apple_save_memory) to target Apple Notes, Calendar, iMessages, etc.