Mneme Memory — Claude Code MCP server: what it does, how to install
Saves developer context and habits across sessions using a local SQLite store. It keeps track of project rules, conventions, and past decisions so the agent does not ask twice.
claude mcp add mneme-memory -- npx -y mneme-memoryWhat Mneme Memory does
Mneme Memory brings persistent memory to coding assistants so you do not repeat project requirements in every new session. It stores all facts locally in an SQLite database. It keeps memory files in Markdown format. You can inspect or modify these text files by hand anytime.
Background workers consolidate related notes and compress stale records over time. When new statements contradict earlier facts, the server pauses the update instead of guessing. It holds conflicts in a queue for user review. You can also restrict context by workspace and project path. This boundary stops unrelated details from leaking across repositories.
Running the server requires Node.js 22 or newer on your machine. Semantic search functions without external API keys if you set the provider to local embeddings or BM25 text retrieval.
What it helps with
- maintain coding conventions across separate chat sessions
- isolate context between different projects and agents
- hold conflicting facts in a queue for manual resolution
- retrieve architectural decisions offline via local search
Example prompts for the agent
- Remember that we use four spaces for indentation and TypeScript for all frontend components.
- Search long-term memory for the database we picked for the billing service last week.
- Check project memory and list our current conventions for writing tests.
How to install Mneme Memory
Platform CLI
claude mcp add mneme-memory -- npx -y mneme-memoryPlatform CLI
codex mcp add mneme-memory -- npx -y mneme-memoryConfig file
{
"mcpServers": {
"mneme-memory": {
"command": "npx",
"args": [
"-y",
"mneme-memory"
]
}
}
}Config file
{
"servers": {
"mneme-memory": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mneme-memory"
]
}
}
}Platform CLI
gemini mcp add mneme-memory npx -y mneme-memoryStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Mneme Memory
How to install Mneme Memory in Claude Code?
Run claude mcp add mneme-memory -- npx -y mneme-memory in your terminal. This registers the server and makes it available to the agent.
What does Mneme Memory do?
It provides cross-session memory for coding agents using an offline SQLite database. The server logs project facts, consolidates duplicate notes, and surfaces past decisions in fresh chats.
Does semantic search require an API key?
No external key is necessary. If configured for local retrieval, it handles search directly on your machine through local embeddings or BM25 keyword matching.
