Skip to main content

A simple Apple Remembers MCP server

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file iflow_mcp_baryhuang_my_apple_remembers-0.1.0.tar.gz.

File metadata

  • Download URL: iflow_mcp_baryhuang_my_apple_remembers-0.1.0.tar.gz
  • Upload date:
  • Size: 44.5 kB
  • Tags: Source
  • Uploaded using 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}

File hashes

Hashes for iflow_mcp_baryhuang_my_apple_remembers-0.1.0.tar.gz
Algorithm Hash digest
SHA256 bbaaacd62c09c2bdc761d6adb9a1729523db1fd62b3194f3bb36f92085057b1f
MD5 c25d3935489f0091a6903526ecd53ffd
BLAKE2b-256 b986c760b1ea78377d9959a57b64ba65c802bee4fd5e925961685569569fed64

See more details on using hashes here.

File details

Details for the file iflow_mcp_baryhuang_my_apple_remembers-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_baryhuang_my_apple_remembers-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 8.6 kB
  • Tags: Python 3
  • Uploaded using 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}

File hashes

Hashes for iflow_mcp_baryhuang_my_apple_remembers-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e38b7d5cc7fc9dc93402fd81592d036d69da7ec8a5a9f5a37b57ef179cee1da0
MD5 c777fb0816a11a457f11a4ba57efe781
BLAKE2b-256 c853950ccdfed9f915212d2bb02fc2b8c4b7a673105ce10b276b72d89f1c942e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page