marvins-local-memory
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Marvin's Local Memory Plugin
A zero-Docker, zero-API-key, cross-platform local memory stack for AI coding assistants and digital companions. Works natively as an Antigravity Plugin and universally as a stdio MCP Server across Claude Code, Cursor, Codex, Windsurf, and OpenClaw on Windows, macOS, and Linux.
Why We Built This
Most local agent memory tools either require heavy Docker containers (Neo4j / Qdrant), burn API credits on every message, scatter databases across random project folders, or silently return blank results when background compactions run.
Marvin's Local Memory Plugin puts everything inside one clean memory/ folder and keeps a lightweight FastEmbed + LanceDB + Bi-Temporal Property Graph daemon warm in RAM:
Zero Docker & Zero API Keys: Embeddings run locally via
FastEmbed(BAAI/bge-small-en-v1.5, 384d) and storage runs embedded on disk viaLanceDB. Background Dream Consolidation pipes episodes viastdinto your localagysubscription CLI (or any custom CLI likeclaude -porollama).Self-Healing Warm Daemon: Automatically calls
checkout_latest()and reopens stale.lancefragment handles so background compactions never causeHTTP 500errors.No Silent Failures: Surfaces an explicit
[MEMORY LAYER WARNING]if recall degrades instead of feeding blank context silently.Bi-Temporal State Tracking: Tracks project phases cleanly and marks old phases
active=Falsewhen you transition forward.
Related MCP server: LumenCore
5-Minute Quickstart
1. Run One-Command Setup
From inside the plugins/marvins-local-memory directory:
python scripts/setup.pyThis installs Python dependencies (lancedb, fastembed, pyarrow, aiohttp), creates your memory/ workspace layout, starts the warm daemon on http://127.0.0.1:8765, and prints the exact copy-paste MCP config snippet for your machine.
2. Connect to Your Harness
Option A: Google Antigravity (Full Native Integration)
Copy or clone
plugins/marvins-local-memory/into~/.gemini/config/plugins/marvins-local-memory/(or load it from your workspaceplugins/folder).Enable Marvin's Local Memory Plugin in Antigravity Customizations.
Antigravity automatically loads:
hooks.json(PreInvocationhook injecting Layers 2A, 2B, 3A, 3B on every turn)mcp_config.json(MCP toolsdeep_recall,search_memory,get_state,set_state,memory_health)rules/AGENTS.md+skills/marvins-local-memory/SKILL.md
Option B: Claude Code, Cursor, Codex, Windsurf, or OpenClaw (Universal MCP)
Add the marvins-local-memory stdio server to your client's MCP configuration (replacing /ABS/PATH/TO with your actual path, or copy the exact JSON printed by python scripts/setup.py):
{
"mcpServers": {
"marvins-local-memory": {
"command": "python",
"args": ["/ABS/PATH/TO/marvins-local-memory/scripts/mcp_server.py"],
"env": {
"COMPANION_MEMORY_DIR": "/ABS/PATH/TO/YOUR_PROJECT/memory"
}
}
}
}Folder Structure Created in Your Project (memory/)
memory/
├── lancedb/ # Embedded vector + BM25 hybrid database
├── graph/ # property_graph.json (entities + bi-temporal edges)
├── dossiers/ # Human-editable working memory sheets (active_focus.md, user_profile.md)
├── dreams/ # Rolling 14-day dream consolidation journals
├── inbox/ # Drop .md notes/session logs here for universal dream ingestion
└── state/ # High-water mark state for incremental consolidation(Recommended: keep periodic backups outside your workspace directory.)
Environment Variables
Variable | Default | Purpose |
|
| Explicit directory for all memory storage folders |
|
| Local port for the warm HTTP daemon ( |
|
| CLI command used for background Dream Consolidation (reads prompt from |
| (empty) | Optional override query when testing |
CLI Commands
# Check daemon + database health
python scripts/query_memory.py --diagnose
# Unified deep recall (2-hop graph + LanceDB)
python scripts/query_memory.py "API refactor decisions"
# Track or transition a project phase live
python scripts/query_memory.py --set-state "project:website" --op ADD --name "My Website" --entity-cat project --phase "Design" --summary "Drafting landing page" --next "Build shop checkout"
# Index existing markdown notes into LanceDB
python scripts/query_memory.py --index ./docs --category knowledge
# Compact LanceDB fragments cleanly (safe while daemon is running!)
python scripts/query_memory.py --compact
# Run background Dream Consolidation (zero API keys)
python scripts/query_memory.py --dreamTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Persistent memory for AI agents. Semantic search, memory graph, W3C DID identity.
Persistent AI memory with semantic search, conflict detection, and ticketing.
Persistent memory and knowledge graphs for AI agents. Hybrid search, context checkpoints, and more.
Persistent memory for AI agents. Hosted cloud connector or local Windows install.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides AI agents with persistent, searchable memory using a knowledge graph stored in SQLite. Features semantic search, temporal awareness, and workflow-aware prompts for development projects.MIT
- AlicenseNot gradedqualityDmaintenanceProvides AI coding assistants with persistent project memory to retain architectural decisions, code patterns, and domain knowledge across sessions. It stores data locally in a SQLite database, allowing agents to remember, recall, and manage project-specific context using full-text search.3 npmApache 2.0
- AlicenseNot gradedqualityDmaintenanceProvides persistent memory for AI tools by building a local knowledge graph from conversations, enabling cross-session recall and context awareness without cloud dependencies.9MIT
- AlicenseNot gradedqualityDmaintenanceProvides a local long-term memory layer for AI coding tools like Cursor and Claude Code, enabling cross-session, cross-tool sharing of project facts, user preferences, decisions, and workflows.11 npm2MIT