Joopsnijder/personal-memory-mcp

Personal Memory MCP Server

A modern MCP (Model Context Protocol) server that provides Claude Desktop with the ability to store and retrieve personal information locally.

Features

• Personal Information: Store and retrieve basic personal details
• Preferences: Organize preferences by category (food, music, work, etc.)
• Memories: Store memories with tags and context for easy searching
• Relationships: Track information about people you know
• Goals: Manage personal and professional goals with status tracking
• Local Storage: All data stored securely in a local JSON file

Quick Start

Prerequisites

• Python 3.10 or higher
• uv package manager

Installation

1. Clone or download this project
2. Install uv if you haven't already:

   curl -LsSf https://astral.sh/uv/install.sh | sh

3. Set up the project:

   cd personal-memory-mcp
   uv sync

Configuration

Add this to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%/Claude/claude_desktop_config.json

Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "personal-memory": {
      "command": "uv",
      "args": ["run", "memory-server"],
      "cwd": "/path/to/personal-memory-mcp"
    }
  }
}

Replace /path/to/personal-memory-mcp with the actual path to your project directory.

Usage

After configuration, restart Claude Desktop. You can then use natural language to interact with your memory:

• "Remember that my favorite coffee is cappuccino"
• "Store that I met Sarah at the conference - she's a data scientist"
• "Add a goal to learn Spanish by the end of the year"
• "What do you remember about my food preferences?"
• "Show me my active goals"

Testing the Server

You can test the server functionality with the MCP Inspector:

uv run mcp dev server.py

Development

Running Tests

uv run pytest

Code Formatting

uv run black .
uv run ruff check .

Running the Server Directly

uv run python memory_server.py

Data Storage

All personal data is stored locally in personal_memory.json in the project directory. The file includes:

• Personal information (name, location, etc.)
• Categorized preferences
• Timestamped memories with tags
• Relationship information
• Goals with status tracking

Privacy & Security

• Local Only: All data stays on your machine
• No Network: No data transmitted to external servers
• Full Control: You own and control all your data
• Backup Friendly: Simple JSON format for easy backup

License

MIT License - see LICENSE file for details.