ukkit/memcord

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:**
**Windows (PowerShell):**
Quick Start
**macOS / Linux:**
**Windows (PowerShell):**
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:**
**Windows (PowerShell):**
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
The --install-hooks flag is idempotent — it merges into existing .claude/settings.json without overwriting other settings or hooks.
Switching an Existing Install to Global Scope
Fresh installs register memcord **globally** (~/.claude.json) by default — available in every project. If you have an older install that's still project-scoped (a local .mcp.json), switch it explicitly — re-running the updater alone won't do this for you, since it auto-detects and preserves an existing project-scoped setup on purpose:
Verify from a *different* project directory: claude mcp list should now show memcord. The original .mcp.json is left in place and still works (harmless, just redundant) — delete it only if you want that directory to stop pinning its own local copy instead of falling through to the global one.
Installing Slash Commands Globally
The 17 memcord-* slash commands ship in .claude/commands/ and are already usable from inside the memcord checkout the moment you clone it. To use them from *any* project directory, install them globally into ~/.claude/commands/:
Fresh installs prompt for this automatically (skipped when non-interactive, e.g. curl | bash). Re-run anytime to change your selection — only memcord's own command files are ever added or removed.