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
ToolLoop: Open-Source Framework for Claude-Style Tools with Any LLM
ToolLoop is an open-source Python framework with 11 tools for file operations, code search, shell access, and sub-agents that works with any LLM through LiteLLM. The 2,700-line framework allows switching models mid-conversation while maintaining shared context.
Interactive Mind Map Visualizes Claude Tool Ecosystem
A developer created an interactive HTML mind map using D3.js to track features across Claude's Chat, Cowork, and Code tools, including platform availability, pricing differences, and connector compatibility.
Open-source Claude Skill structures B2B SaaS growth knowledge for consistent AI reasoning
A developer created an open-source Claude Skill that organizes $90M ARR partnership lessons, 1,800 user interviews, and 5 SaaS case studies into structured knowledge for Claude to reference, improving output quality for complex workflows like PMF validation and GTM planning.
Giving Claude a Local LLM as an Assistant via MCP on Mac
A developer connects Claude to a local Qwen 2.5 Coder 14B via Ollama and MCP, creating a no-cost assistant for delegating tasks like text processing and handling large files.