Memcord

MEMCORD v4.3.6 (mcp server) This privacy-first, self-hosted MCP server helps you organize chat history, summarize messages, search across past chats with AI — and keeps everything secure and fully under your control.

Never Lose Context Again Transform your Claude conversations into a searchable, organized knowledge base that grows with you

What's new in v4.3.6 — removes two unnecessary dependencies (pandas, python-magic) from a fresh install; CSV/TSV import now uses the standard library instead of pandas.

Table of Contents

• Core Benefits
• Prerequisites
• Quick Start
• Keeping Memcord Updated
• Using Memcord
• Custom Storage Path
• Summarizer Backends
• IDE Configuration
• Documentation

Core Benefits

• Infinite Memory - Claude remembers everything across unlimited conversations with intelligent auto-summarization
• Your Data, Your Control - 100% local storage with zero cloud dependencies or privacy concerns
• Effortless Organization - Per-project memory slots with timeline navigation and smart tagging
• Intelligent Merging - Automatically combines related conversations while eliminating duplicates

Prerequisites

Python 3.10+ and uv are required. The installer handles both — click to expand manual instructions.

• Python 3.10+ — python.org

• uv (Python package manager) — install with:

  macOS / Linux:

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

  Windows (PowerShell):

  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  

Quick Start

macOS / Linux:

curl -fsSL https://github.com/ukkit/memcord/raw/main/install.sh | bash

Windows (PowerShell):

irm https://github.com/ukkit/memcord/raw/main/install.ps1 | iex

This will:

• ✅ Download and setup memcord
• ✅ Set up Python virtual environment using uv
• ✅ Generate platform-specific MCP configuration files
• ✅ Configure Claude Desktop, Claude Code, VSCode, and Antigravity IDE

Keeping Memcord Updated

Re-run the same installer command from Quick Start from the same folder where memcord is installed — it detects an existing installation and updates it in place instead of cloning a fresh copy:

macOS / Linux:

curl -fsSL https://github.com/ukkit/memcord/raw/main/install.sh | bash

Windows (PowerShell):

irm https://github.com/ukkit/memcord/raw/main/install.ps1 | iex

This will:

• ✅ Pull the latest changes (fast-forward only — aborts safely if you have local edits)
• ✅ Reuse your existing virtual environment and upgrade dependencies
• ✅ Regenerate MCP configuration files
• ✅ Leave your memory data (memory_slots/) and generated configs untouched

Manual update

cd /path/to/memcord
git pull
uv pip install -e . --upgrade
uv run python scripts/generate-config.py  # Regenerate configs

# Optional: Enable auto-save hooks (new in v2.5.0)
uv run python scripts/generate-config.py --install-hooks

The --install-hooks flag is idempotent — it merges into existing .claude/settings.json without overwriting other settings or hooks.