neural-memory — Claude Code MCP server: memory and setup
This MCP server keeps agent memories between sessions and retrieves related facts through a graph. Use it when project context must carry across runs.
claude mcp add neural-memory -- npx -y neural-memory-mcpWhat neural-memory does
neural-memory stores facts, decisions, errors, preferences, and other records as connected memory items. Its recall process follows associations between them instead of relying only on matching words. The MCP tools cover saving memories, recalling context, and checking brain health, while session and maintenance work runs in the background.
The server runs locally without a vector database or API calls. It initializes itself on first use, so there is no separate init step. Documents in PDF, DOCX, PPTX, HTML, JSON, XLSX, and CSV can be ingested as lasting knowledge. Device-to-device sync uses a Cloudflare Worker deployed in your own account.
The project lists Python 3.11+, so that version should be checked before setup. Cloud sync also needs your own Cloudflare account and D1 database. Local recall does not depend on either service.
What it helps with
- keep project decisions across agent sessions
- trace related memories through cause-and-effect links
- load knowledge from PDF and office documents
- inspect the health of stored memory
- sync one memory store across devices
Example prompts for the agent
- Remember that this project uses PostgreSQL for its database decision.
- Recall the related context behind the authentication changes.
- Check the memory health and suggest fixes for the issues you find.
How to install neural-memory
Platform CLI
claude mcp add neural-memory -- npx -y neural-memory-mcpPlatform CLI
codex mcp add neural-memory -- npx -y neural-memory-mcpConfig file
{
"mcpServers": {
"neural-memory": {
"command": "npx",
"args": [
"-y",
"neural-memory-mcp"
]
}
}
}Config file
{
"servers": {
"neural-memory": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"neural-memory-mcp"
]
}
}
}Platform CLI
gemini mcp add neural-memory npx -y neural-memory-mcpStep 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 neural-memory
How do I install neural-memory in Claude Code?
Run claude mcp add neural-memory -- npx -y neural-memory-mcp, then restart Claude Code.
What does neural-memory do?
It gives an agent persistent memory between sessions and recalls connected records through graph activation. The server also exposes a health check and handles background context work.
Does neural-memory require an API or vector database?
Local operation uses neither API calls nor a vector database. Cross-device sync requires a Cloudflare Worker and D1 database in your own account.
