
Memory Mcp
Adds persistent memory to Claude Code by automatically saving and retrieving conversation context across sessions. Uses vector embeddings to store two types of knowledge: episodes (full conversation sessions with summaries) and entities (extracted decisions, preferences, and concepts). Integrates via hooks in Claude Code's settings.json to auto-save messages on UserPromptSubmit and Stop events, then injects relevant history from past sessions as context. Exposes tools like memory_recall for semantic search, memory_add_entity for manual knowledge capture, and memory_start_episode for session management. Storage splits between user-level (~/.claude-memory) for cross-project preferences and project-level (.claude/memory) for project-specific decisions. Requires a one-time 400MB model download and Python 3.10-3.13. Useful when you want Claude to remember architectural decisions, coding preferences, or project context without re-explaining everything each session.
- GitHub stars
- 11
- tools
- 17
- transport
- STDIO
- env var
- 1
- last updated
- Feb 12, 2026
Tools
17 toolsPublic tool metadata for what this MCP can expose to an agent.
memory_start_episodeStart a new episode
Start a new episode
No parameter schema in public metadata yet.
memory_close_episodeClose and archive current episode
Close and archive current episode
No parameter schema in public metadata yet.
memory_get_current_episodeGet current active episode
Get current active episode
No parameter schema in public metadata yet.
memory_add_entityAdd a knowledge entity
Add a knowledge entity
No parameter schema in public metadata yet.
memory_confirm_entityConfirm a detected entity candidate
Confirm a detected entity candidate
No parameter schema in public metadata yet.
memory_reject_candidateReject a false detection
Reject a false detection
No parameter schema in public metadata yet.
memory_deprecate_entityMark an entity as outdated
Mark an entity as outdated
No parameter schema in public metadata yet.
memory_get_pendingList pending entity candidates
List pending entity candidates
No parameter schema in public metadata yet.
memory_recallSemantic search across episodes and entities
Semantic search across episodes and entities
No parameter schema in public metadata yet.
memory_search_by_typeSearch entities by type
Search entities by type
No parameter schema in public metadata yet.
memory_get_episode_detailGet full episode details
Get full episode details
No parameter schema in public metadata yet.
memory_list_episodesList all episodes chronologically
List all episodes chronologically
No parameter schema in public metadata yet.
memory_statsGet system statistics
Get system statistics
No parameter schema in public metadata yet.
memory_encoder_statusCheck vector encoder status
Check vector encoder status
No parameter schema in public metadata yet.
memory_cache_messageManually cache a message
Manually cache a message
No parameter schema in public metadata yet.
memory_clear_cacheClear message cache
Clear message cache
No parameter schema in public metadata yet.
memory_cleanup_messagesClean up old cached messages
Clean up old cached messages
No parameter schema in public metadata yet.
Sponsors
Configuration
CLAUDE_PROJECT_ROOT项目根目录路径
Readme
Memory MCP Service
A persistent memory MCP service for Claude Code. Automatically saves conversations and retrieves relevant history across sessions.
What it does: Every time you chat with Claude Code, your conversation context (decisions, preferences, key discussions) is saved and automatically recalled in future sessions — so Claude always has the background it needs. Memory recall demo - retrieving past session history
Quick Start
Prerequisites
Install uv (Python package runner):
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
# Mac/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
Details
- Repository
- github.com/chenxiaofie/memory-mcp
- Category
- AI & LLM Tools
- Package
chenxiaofie-memory-mcp- Transport
- STDIO
- Registry
- MCP registry, active