Memento v1.0: Persistent Memory MCP Server for Claude Code with 17 Tools
Memento v1.0 is a persistent memory MCP server for Claude Code that gives AI coding agents long-term memory across sessions. The tool runs entirely locally with no cloud dependencies, API keys, or telemetry.
Core Features
The server ships with 17 MCP tools: save, recall, search, forget, list, export, import, ingest, index, migrate, compact, stats, profile, related, session start, session summary, and health.
Search Capabilities
- Vector search: Uses cosine similarity with HNSW index to find memories by meaning
- Keyword search: Full BM25 implementation (same algorithm as Elasticsearch) for exact term matching
- Hybrid search: Combines 70% vector + 30% BM25 scoring, which the creator uses daily
Intelligent Memory Management
- Contradiction detection: Automatically creates supersedes relationships when you change decisions (e.g., "we use PostgreSQL" → "switched from PostgreSQL to CockroachDB") and deprioritizes old information
- Importance scoring: Explicit saves > auto-captures, decisions > conversation, with 347-day exponential decay so recent context surfaces first
- Knowledge graph: Extracts file paths, functions, classes, packages, URLs, and environment variables from every memory
Visualization and API
memento serve starts a local server at localhost:7007 that provides:
- D3.js force-directed graph visualization with nodes colored by tag and edges showing relationships
- REST API mirroring all 17 tools
Production Features
- Circuit breaker for fault tolerance
- Write-ahead log for crash recovery
- LRU cache for embeddings
IDE and Browser Integration
- Multi-IDE support: Claude Code, Cursor, Windsurf, OpenCode with shared memory store across all four
- Chrome extension: Right-click any page or selection to save it directly to memory
Usage Data
During v1.0 development, Memento captured 2,191 memories across 27 sessions: 1,905 from auto-capture hooks, 206 from session summaries, and 79 explicit saves. This created 53MB of searchable engineering context.
Setup and Resources
Setup command: npx memento-memory setup
- GitHub: https://github.com/sanathshetty444/memento
- Documentation: https://sanathshetty444.github.io/memento/
- Full writeup: https://medium.com/@sanathshetty444/it-remembered-9e7d10f444ff
📖 Read the full source: r/ClaudeAI
👀 See Also
FixAI: Browser Game Teaches Consumer Law by Fighting Corporate AI Bots
FixAI is a browser game with 36 levels where players argue against corporate or government AI systems using real consumer laws. Built with Vanilla JS, Node/Express, and Claude Haiku, it features a resistance scoring system and educational explanations of legal arguments.
Open Source System Captures Claude Code Patterns into Evolving Documentation
Developer Lee Fuhr has released three open source repositories that systematically capture and codify learnings from working with Claude Code. The system includes a methodology document with 14 principles and 19 patterns, an architecture classification framework, and a memory system with 149 features.
Claude Code documentation includes excessive React components inflating token counts
Analysis of Claude Code's LLM documentation reveals that MDX files contain massive inlined React components, with context-window.md using 18,501 tokens but only 551 tokens of actual documentation content.
Claude Code Hooks Implementation Project Covers All 23 Hooks
A developer has built a project entirely with Claude code that implements all 23 Claude code hooks, with a video explaining each hook's use case and a GitHub repository available.