chenxiaofie avatar

Memory Mcp

chenxiaofie/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 tools

Public 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

PyPI version Python License: MIT

English | 中文

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

View the full README on GitHub

Details

Repository
github.com/chenxiaofie/memory-mcp
Category
AI & LLM Tools
Package
chenxiaofie-memory-mcp
Transport
STDIO
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1usejunior avatarAgent Emailusejunior/email-agent-mcpLocal email connectivity for AI agents — read, draft, send, and organize Outlook mail via MCP7stars
2agentic-eng avatarA2dbagentic-eng/a2dbSafe, read-only database access for AI agents. 5 databases, batch queries, SQLGlot.2stars
3elfsight avatarElfsight AI Chatbotelfsight/ai-chatbot-mcpRead conversations, leads, knowledge base and analytics of your Elfsight AI Chatbot widgets.2stars
4mlava avatarAgent Readymlava/agent-ready-mcpScan any URL for AI agent readability — Vercel Spec, llmstxt.org, and agent-protocol manifests.2stars
5rumblingb avatarAgent Audit Mcprumblingb/agent-audit-mcpImmutable audit trail for agent-to-agent interactions2stars
6base76-research-lab avatarCognos Session Memorybase76-research-lab/cognos-session-memoryCognOS trust scoring (C=p·(1-Ue-Ua)) and session trace storage as MCP tools.1stars