Skip to main content

MCP Server - My Apple Remembers

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

Docker Pulls License: MIT

image

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.

Metadata

Release files for iflow-mcp_baryhuang_my-apple-remembers 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iflow-mcp_baryhuang_my-apple-remembers 0.1.0
File Size Uploaded
iflow_mcp_baryhuang_my_apple_remembers-0.1.0.tar.gz 44.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for iflow-mcp_baryhuang_my-apple-remembers 0.1.0
File Interpreter ABI Platform
iflow_mcp_baryhuang_my_apple_remembers-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 53.1 kB

Release files / iflow_mcp_baryhuang_my_apple_remembers-0.1.0.tar.gz

Download URL iflow_mcp_baryhuang_my_apple_remembers-0.1.0.tar.gz
Size 44.5 kB
Tags Source
SHA-256 checksum
How to use checksums
bbaaacd62c09c2bdc761d6adb9a1729523db1fd62b3194f3bb36f92085057b1f
BLAKE2b-256 checksum
How to use checksums
b986c760b1ea78377d9959a57b64ba65c802bee4fd5e925961685569569fed64
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / iflow_mcp_baryhuang_my_apple_remembers-0.1.0-py3-none-any.whl

Download URL iflow_mcp_baryhuang_my_apple_remembers-0.1.0-py3-none-any.whl
Size 8.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e38b7d5cc7fc9dc93402fd81592d036d69da7ec8a5a9f5a37b57ef179cee1da0
BLAKE2b-256 checksum
How to use checksums
c853950ccdfed9f915212d2bb02fc2b8c4b7a673105ce10b276b72d89f1c942e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page