Local memory MCP server for Claude Code and Codex

 –   – 

Why · Quick Start · Compare · Tiers · Benchmarks · API · Docs · FAQ · Discord

Why TrueMemory

It finds signal in the noise. Your AI sees thousands of messages. TrueMemory figures out which ones actually matter and throws away the rest. No manual tagging, no prompt engineering. It just knows.

It gets sharper over time. It's not a static database. It's a living memory that grows with you. It resolves contradictions when you change your mind, updates stale facts, and consolidates what it knows. The longer you use it, the better it gets.

It works without you thinking about it. TrueMemory automatically captures memories from your conversations and automatically injects the right ones into your next session. You never have to store or search for anything manually. It just happens.

It's 100% local. One SQLite file on your machine. Your memories never leave your device. No cloud, no API keys needed. Your data is yours. (Anonymous usage telemetry is the only exception — never memory content — and one env var turns it off. Details.)

Without TrueMemory: "What framework are we using?" Asked for the 12th time this week. Your agent starts every session with amnesia. It doesn't know your name, your stack, or anything you told it yesterday.

With TrueMemory: Your agent already knows you use FastAPI, prefer Pydantic v2, and that your auth middleware lives in src/auth/. It remembers your corrections, your preferences, and your decisions. Across every session, forever.

Join the Discord to see what others are building with TrueMemory.

How TrueMemory Compares

All benchmarks independently reproducible. Scripts included in benchmarks/.

Quick Start

For Claude Code / Claude CLI / Cursor / Codex CLI / Gemini CLI

curl -LsSf https://raw.githubusercontent.com/buildingjoshbetter/TrueMemory/main/install.sh | sh

Installs everything in an isolated environment. Downloads ~1.5GB of AI models. No data leaves your machine. No sudo required.

irm https://raw.githubusercontent.com/buildingjoshbetter/TrueMemory/main/install.ps1 | iex

That's it. TrueMemory remembers your conversations automatically from here. Need help? Join our Discord.

If TrueMemory saves you time, a ⭐ helps other devs find it.

For developers (Python library)

pip install truememory

from truememory import Memory

m = Memory()
m.add("Prefers dark mode and TypeScript", user_id="alex")
print(m.search("preferences", user_id="alex"))

Tiers

Same architecture, three tiers. All included in a single install. Switch anytime by saying "switch to Pro" or "switch to Base."

Edge works everywhere. Base is the strongest fully-offline tier. Pro adds AI-powered query expansion for the highest scores.

Benchmarks

Tested across three major benchmarks with all systems sharing the same answer model (GPT-4.1-mini), judge (GPT-4o-mini, 3x majority vote), and scoring pipeline.

Reproduce any result yourself

Every benchmark script is self-contained and runs on Modal.

• LoCoMo Scripts — 8 systems (TrueMemory, Mem0, Zep, Engram, etc.)
• LoCoMo Results — per-category breakdowns, latency, cost
• LoCoMo Eval Config — exact models, prompts, parameters
• LongMemEval Scripts — oracle + strict variants
• LongMemEval Results — 6 TM Pro runs + 5 competitor results
• BEAM-1M Script — 35 conversations at 1M+ tokens
• BEAM-10M Script — 10 conversations at 10M tokens
• BEAM Results — 3 runs (1M) + 1 run (10M)

All benchmarks use the same eval pipeline. Nothing is hidden. Full details: LoCoMo | LongMemEval | BEAM

Works With

Claude Code · Claude CLI · Cursor · Codex CLI · Gemini CLI · Claude Desktop

Lifecycle hooks capture conversations automatically. No manual work needed. Your memories stay local in a single SQLite file.

Python API

from truememory import Memory

m = Memory()

m.add("Prefers dark mode and TypeScript", user_id="alex")
m.add("Works at Anthropic as a senior engineer", user_id="alex")
m.add("Always sign commits with GPG", directive=True)  # directives auto-load every session

results = m.search("What are Alex's preferences?", user_id="alex")
results = m.search_deep("career history?", user_id="alex")  # multi-round, higher accuracy

Full API reference →

Docs

FAQ

Get Started in 60 Seconds

For Claude Code, Claude CLI, Cursor, Codex CLI, or Gemini CLI:

curl -LsSf https://raw.githubusercontent.com/buildingjoshbetter/TrueMemory/main/install.sh | sh

Using it as a Python library instead? pip install truememory

Questions? Join our Discord or open a Discussion. If TrueMemory saves you time, give us a ⭐

Thanks to Our Contributors

buildingjoshbetter

SoilChang

Huntehhh

mseep-ai

adityajha2005

shivamverma1999

Adarsh-031

nareshkarthigeyan

Research

TrueMemory is backed by a research paper (arXiv preprint) on retrieval-centered agent memory.

Storage Is Not Memory: A Retrieval-Centered Architecture for Agent Recall (arXiv 2605.04897)

@article{sauronlabs2026storage,
  title   = {Storage Is Not Memory: A Retrieval-Centered Architecture for Agent Recall},
  author  = {Sauron Labs},
  journal = {arXiv preprint arXiv:2605.04897},
  year    = {2026},
  url     = {https://arxiv.org/abs/2605.04897}
}

Community

• Join our Discord for help, feedback, and updates
• Follow @Building_Josh on X for updates
• Follow @Sauron_Labs for company news
• Open a Discussion for questions or ideas
• Read the paper on arXiv
• Visit truememory.net · sauronlabs.ai

If TrueMemory saves you time, give us a ⭐

Translations

Read this in: 简体中文 · हिन्दी · Español · Français · العربية · বাংলা · Português · Русский · 日本語 · 한국어 · Deutsch · Bahasa Indonesia · Tiếng Việt · Türkçe · Italiano · ไทย · Polski · Українська · Nederlands

License

AGPL-3.0. Free for personal and research use. Commercial use requires a separate license. Contact josh@sauronlabs.ai.

TrueMemory, a sauron company