A
licenseNot graded
qualityD
maintenanceLong-term memory MCP server for Claude Code with SQLite FTS5 full-text search, BM25 ranking, access tracking, and upsert deduplication. Zero config via npx.
32 npm
MIT
memory-mcp
by AyubMoh1
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@memory-mcpremember that I prefer dark mode for coding"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
memory-mcp
Persistent memory MCP server for Claude Code. Store, search, and retrieve memories across sessions using hybrid vector + keyword search powered by SQLite, FTS5, and sqlite-vec.
Features
Hybrid search — 70% vector similarity + 30% BM25 keyword matching
Local embeddings — Ollama (required, local, free)
Persistent storage — SQLite database survives across sessions
Token-aware context — Retrieve memories fitted within a token budget
File watching — Auto-index markdown and code files on change
LRU embedding cache — 10k entries, SHA256-keyed dedup
Related MCP server: recall-mcp
Setup
git clone https://github.com/AyubMoh1/memory-mcp.git
cd memory-mcp
npm install
npm run buildRegister with Claude Code
Add to ~/.claude/config.json:
{
"mcpServers": {
"memory": {
"command": "node",
"args": ["/path/to/memory-mcp/dist/index.js"]
}
}
}Tools
Tool | Description |
| Store a memory with category, tags, and importance |
| Hybrid vector + keyword search |
| List recent memories with filters |
| Delete a memory by ID |
| Token-budgeted context retrieval for a topic |
| Storage statistics |
Resources
Resource | URI | Description |
Stats |
| JSON storage statistics |
Recent |
| Last 20 memories |
Configuration
All configuration is via environment variables:
Variable | Default | Description |
|
| Database file location |
| (empty) | Comma-separated file paths to auto-index |
|
| Ollama server URL |
| — | Enable debug logging |
Embeddings
Ollama is required. The server will fail to start without a running Ollama instance and an embedding model installed.
ollama serve # Start Ollama
ollama pull nomic-embed-text # Install embedding modelArchitecture
src/
├── index.ts # Entry point: MCP server + stdio transport
├── storage/
│ ├── types.ts # MemoryChunk, SearchResult, StorageBackend
│ └── database.ts # SQLite + FTS5 + sqlite-vec
├── embeddings/
│ ├── providers.ts # Ollama embedding provider
│ ├── cache.ts # LRU embedding cache
│ └── detect.ts # Detect Ollama + embedding model
├── sync/
│ ├── file-watcher.ts # chokidar with debouncing
│ └── chunker.ts # Split files by headers/paragraphs
├── tools/ # MCP tool handlers
├── resources/ # MCP resource handlers
└── utils/ # Logger, ID gen, token estimationLicense
MIT
This server cannot be deployed
Maintenance
ActivityInactive
ResponsivenessNo issues
Related MCP Connectors
- mcpOAuthai.butlerbrain
Persistent memory for AI assistants. Save once; recall from Claude, ChatGPT, or any MCP client.
Persistent memory for AI agents across Claude, ChatGPT and any MCP client.
Private persistent memory for Claude, ChatGPT & Gemini via MCP - semantic search, zero-code setup.
Persistent AI memory shared across Claude, ChatGPT, coding agents, and compatible MCP clients.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenancePersistent memory MCP server for AI coding agents. Stores, searches, and retrieves context across sessions using SQLite and FTS5.-
- AlicenseNot gradedqualityDmaintenanceMCP Memory Server for Claude Code that provides persistent context across sessions using semantic search (RAG).Apache 2.0
- FlicenseNot gradedqualityDmaintenanceA lightweight MCP memory server built on SQLite + FTS5, providing cross-session long-term memory for Claude Code.-