Mnemosyne
Local-first agent memory in one SQLite file; corrections retire dependent memories
- Pricing
- Open source
- Platforms
- CLI, self-hosted, API
- Runs
- Locally
- Version
- 3.0.0-rc.4
- Listing updated
- 3 days ago
About Mnemosyne
Mnemosyne is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Mnemosyne tackles stale agent memory. Every record keeps its source and trust tier, and when a source is corrected, the procedures and skills recorded as depending on it are retired, so the next agent starts from evidence still supported. The 3.0 pre-release can also propose dependencies nobody declared, for review. The superseded version stays inspectable, and past beliefs can be replayed exactly.
The local engine needs no model API key, database server or Docker, and it can run over MCP, a TypeScript SDK, a CLI or authenticated HTTP. The site pairs its numbers with their limits, such as 81.8% on a 500-question memory benchmark read by Claude Sonnet 4.6 and judged by Claude Haiku 4.5, where the prompt was tuned on 100 of those questions.
This is the TypeScript package mnemosy-ai, MIT-licensed on Node.js 22.16 or newer, with 2.0.0 stable and 3.0.0 release candidates on the next tag. The README stresses it is a separate project from the Python mnemosyne-memory package.
Install
Run in a terminal
claude mcp add mnemosyne -- npx -y mnemosy-aiAdd to claude_desktop_config.json
{
"mcpServers": {
"mnemosyne": {
"command": "npx",
"args": [
"-y",
"mnemosy-ai"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mnemosyne": {
"command": "npx",
"args": [
"-y",
"mnemosy-ai"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mnemosyne": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mnemosy-ai"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mnemosyne": {
"command": "npx",
"args": [
"-y",
"mnemosy-ai"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mnemosyne": {
"command": "npx",
"args": [
"-y",
"mnemosy-ai"
]
}
}
}Configuration
MNEMOSYNE_INDEX_MODEDense index used for semantic recall; defaults to auto
What it does
- Evidence on every memory
- Each record keeps its source, trust tier and superseded versions.
- Correction cascades
- Fixing a source retires memories recorded as depending on it.
- Replayable history
- Past beliefs replay exactly and a bisect tool finds records that displaced others.
- Skill trials
- Candidate skills need passed trials before entering ordinary advice.
- Several hosts
- MCP, TypeScript SDK, CLI and authenticated HTTP.
- Local backups
- Verified local backups let you rehearse recovery.
Good for
- Give a coding agent memory that survives sessions
- Stop an agent reusing a lesson based on a corrected requirement
- Audit why a retrieval missed a record
- Carry decisions and next steps into the next session
- Run agent memory offline without an API key
Pricing
Open source
MIT licensed; runs locally
Prices change. Check mnemosy.ai before you buy.
Mnemosyne FAQ
Does it need an API key or database?
No. The README says the local engine needs no model API key, database server or Docker.
Which version should I install?
2.0.0 is stable on npm latest. The 3.0.0 release candidate is on npm next.
Is it the same as the Python mnemosyne project?
No. The README says they share a name only.
What licence and runtime?
MIT, with Node.js 22.16 or newer.
Is Mnemosyne free?
Yes. Mnemosyne is open source, so you can use and self-host it for free.
How do I add Mnemosyne to Claude Code?
Run this command in your terminal: claude mcp add mnemosyne -- npx -y mnemosy-ai
What are the best alternatives to Mnemosyne?
The closest alternatives to Mnemosyne are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.
Alternatives to Mnemosyne

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
Not checked yet- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity
MedXpert 图书馆连接器(通用版)
MCP serverLocal MCP server that searches and answers questions over your own Markdown wiki
Runs locally- 4 tools
- Open source
- Knowledge and memory