MCPgee
MCPgee
MCPgeeMCPgee

My Apple Remembers

v1.0.0•Knowledge & Memory•stable

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 requirement

agent-memoryagentic-aimacosmcp-server
Share:
10
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is My Apple Remembers?

My Apple Remembers is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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 a...

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 requirement

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A lightweight MCP server that integrates with Apple Notes to

Use Cases

Create a personal memory system for AI using Apple Notes.
Save and recall information from your Mac through simple commands.
honeybluesky

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedDec 10, 2025
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx my-apple-remembers

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use My Apple Remembers

My Apple Remembers is a lightweight MCP server that uses AppleScript over SSH to integrate Apple Notes into a persistent memory system for AI assistants. It exposes two tools: one to save information to a designated Apple Notes note, and one to recall stored memories. This gives Claude and other MCP-compatible agents a durable, human-readable memory store that lives on your Mac inside the Notes app — no cloud service, no subscription, and no third-party storage required. The server runs in a Docker container and connects to your Mac via SSH credentials.

Prerequisites

  • macOS with Apple Notes app enabled and accessible
  • SSH enabled on your Mac (System Settings → General → Sharing → Remote Login)
  • Docker Desktop installed and running
  • Your macOS username and password (used for SSH authentication by the container)
  • Claude Desktop or another MCP-compatible client
1

Enable SSH on your Mac

The Docker container connects to your Mac via SSH to execute AppleScript commands. Enable Remote Login in System Settings.

# Enable SSH via command line (requires admin password)
sudo systemsetup -setremotelogin on

# Verify SSH is active
systemsetup -getremotelogin
2

Clone the repository and build the Docker image

Clone the my-apple-remembers repository and build the Docker image locally.

git clone https://github.com/honeybluesky/my-apple-remembers.git
cd my-apple-remembers
docker build -t mcp-my-apple-remembers .
3

Test the Docker container manually

Run the container with your macOS credentials to verify it can connect and execute AppleScript. Replace the placeholder values with your actual username, password, and hostname.

docker run -i --rm \
  -e MACOS_USERNAME=your-mac-username \
  -e MACOS_PASSWORD=your-mac-password \
  -e MACOS_HOST=localhost \
  mcp-my-apple-remembers
4

Find your Mac's hostname

If running the container on the same Mac, use 'localhost'. If running on a different machine, find the target Mac's hostname or IP address.

# Get hostname of current Mac
hostname

# Or get IP address
ipconfig getifaddr en0
5

Configure Claude Desktop

Add the my-apple-remembers server to your Claude Desktop configuration. The server runs as a Docker container so Docker must be running when Claude Desktop starts.

6

Restart Claude Desktop and create a memory

After restarting Claude Desktop, ask Claude to save a piece of information to test that the save and recall tools are working correctly.

My Apple Remembers Examples

Client configuration

Claude Desktop configuration using the Docker image. Replace MACOS_USERNAME and MACOS_PASSWORD with your actual macOS credentials.

{
  "mcpServers": {
    "my-apple-remembers": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MACOS_USERNAME=your-mac-username",
        "-e", "MACOS_PASSWORD=your-mac-password",
        "-e", "MACOS_HOST=localhost",
        "mcp-my-apple-remembers"
      ]
    }
  }
}

Prompts to try

These queries use the my_apple_save_memory and my_apple_recall_memory tools to interact with Apple Notes.

- "Remember that my AWS production account ID is 123456789 and save it to my notes."
- "What have you saved about my project preferences?"
- "Save this meeting summary to my Apple Notes memory: [paste your notes here]."
- "Recall everything you know about my current project goals."
- "Save my preferred code style guidelines so you can reference them in future sessions."

Troubleshooting My Apple Remembers

Docker container cannot connect to Mac via SSH — 'Connection refused' error

Verify SSH is enabled: run 'sudo systemsetup -getremotelogin' and confirm it returns 'On'. If running the container on the same Mac as the target, use MACOS_HOST=host.docker.internal instead of localhost, as Docker containers use a special hostname to reach the host machine.

SSH authentication fails with 'Permission denied'

Ensure MACOS_USERNAME is your short macOS account name (visible in System Settings → Users & Groups, not the display name). Verify the password is correct by testing SSH manually in a terminal: ssh your-username@localhost. If prompted about host key verification, accept it once from your terminal — this saves the key to known_hosts.

Apple Notes does not show saved memories

The server saves to a specific note in Apple Notes via AppleScript. Check the Notes app for a note created by the AppleScript. If Notes is not running, AppleScript may fail silently — open the Notes app before testing the server.

Frequently Asked Questions about My Apple Remembers

What is My Apple Remembers?

My Apple Remembers is a Model Context Protocol (MCP) server that 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 requirement It connects AI assistants to external tools and data sources through a standardized interface.

How do I install My Apple Remembers?

Follow the installation instructions on the My Apple Remembers GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with My Apple Remembers?

My Apple Remembers works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is My Apple Remembers free to use?

Yes, My Apple Remembers is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

My Apple Remembers Alternatives — Similar Knowledge & Memory Servers

Looking for alternatives to My Apple Remembers? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.

MemPalace

★ 52.6k

A local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically

Kratos

★ 25.7k

🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.

Context Mode

★ 15.4k

An MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm

Memu

★ 13.7k

Memory for 24/7 proactive agents like OpenClaw.

MemOS

★ 9.3k

MemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u

Everos

★ 5.4k

Build, evaluate, and integrate long-term memory for self-evolving agents.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Knowledge & MemoryBrowse All Servers

Quick Config Preview

{ "mcpServers": { "my-apple-remembers": { "command": "npx", "args": ["-y", "my-apple-remembers"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use My Apple Remembers?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides