Truememory
A living memory system that ingests long-horizon data to infer insights, enabling more decisive action, all while running on a single SQLite file locally.
What is Truememory?
Truememory is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to living memory system that ingests long-horizon data to infer insights, enabling more decisive action, all while running on a single sqlite file locally.
A living memory system that ingests long-horizon data to infer insights, enabling more decisive action, all while running on a single SQLite file locally.
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A living memory system that ingests long-horizon data to inf
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx truememoryConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Truememory
TrueMemory is a local-first, long-term memory system for AI agents that stores and retrieves memories using a single SQLite file on your machine. It uses a 6-layer search pipeline with reranking to surface the most relevant past memories in under 200ms, and supports multi-round agentic deep retrieval for complex queries. Developers use it with Claude Code, Cursor, and other AI coding agents to give those agents persistent context about their preferences, project history, and instructions across sessions — without sending any memory content to external servers.
Prerequisites
- Python 3.10 or later
- pip to install the truememory package
- An MCP-compatible client such as Claude Desktop, Claude Code, or Cursor
- Optionally, the TrueMemory install script for a managed binary installation
Install TrueMemory
Install TrueMemory using the official install script (recommended for CLI tools like Claude Code) or via pip for Python API use.
curl -LsSf https://raw.githubusercontent.com/buildingjoshbetter/TrueMemory/main/install.sh | shOr install as a Python package
If you prefer pip or need the Python API for direct integration, install from PyPI.
pip install truememoryConfigure your MCP client
Add TrueMemory as an MCP server in your client's config file. The server stores all memories in ~/.truememory/memories.db — no additional environment variables are required for basic use.
{
"mcpServers": {
"truememory": {
"command": "truememory",
"args": ["serve"]
}
}
}Restart your MCP client
Quit and reopen Claude Desktop or reload Claude Code. TrueMemory exposes 11 MCP tools for adding, searching, updating, and deleting memories.
Add your first directive memory
Directive memories are automatically loaded as instructions at the start of every session. Use them to persist coding preferences, commit message formats, or workflow rules.
Truememory Examples
Client configuration
Claude Desktop configuration for TrueMemory running as a local MCP server.
{
"mcpServers": {
"truememory": {
"command": "truememory",
"args": ["serve"],
"env": {
"TRUEMEMORY_TELEMETRY": "off"
}
}
}
}Prompts to try
Example prompts demonstrating memory storage, retrieval, and directive-based instructions.
- "Remember that I always use dark mode and prefer TypeScript with strict mode enabled."
- "What do you know about my coding preferences?"
- "Save this as a directive: always run the test suite before committing."
- "Search your memory for anything related to the authentication service we discussed."
- "Show me all memories you have stored for this project."
- "Forget the old database schema notes — the schema has changed."Troubleshooting Truememory
truememory command not found after running the install script
The install script adds the binary to ~/.local/bin. Add this to your PATH with 'export PATH=$HOME/.local/bin:$PATH' in your ~/.zshrc or ~/.bashrc, then restart your terminal before launching your MCP client.
Memories are not persisting between sessions
Verify that the SQLite database at ~/.truememory/memories.db is being written to by checking its file size after adding memories. If it remains empty, ensure the MCP server process has write permission to the ~/.truememory directory.
Search returns irrelevant or no results
TrueMemory's search pipeline uses semantic similarity. Phrase your search queries as natural questions rather than keywords (e.g., 'What are my TypeScript preferences?' rather than 'typescript'). Use search_deep for multi-round retrieval on complex topics.
Frequently Asked Questions about Truememory
What is Truememory?
Truememory is a Model Context Protocol (MCP) server that living memory system that ingests long-horizon data to infer insights, enabling more decisive action, all while running on a single sqlite file locally. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Truememory?
Follow the installation instructions on the Truememory GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Truememory?
Truememory works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Truememory free to use?
Yes, Truememory is open source and available under the AGPL-3.0 license. You can use it freely in both personal and commercial projects.
Truememory Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to Truememory? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.
MemPalace
★ 52.6kA 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.4kAn 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.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (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.4kBuild, 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.
Set Up Truememory in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Truememory?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.