Memory MCP is an MCP server that provides intelligent project memory management for Claude Code, enabling persistent storage and retrieval of project-specific information.
Core Capabilities:
Recall memories (
recall_memory_tool): Query and retrieve relevant information using natural language, keywords, or questions to find stored project knowledgeStore memories (
memorize_memory_tool): Save valuable information discovered during development, such as architectural decisions, configuration details, or important insightsPersistent storage: Automatically stores memories as Markdown files in the project's
.memoriesdirectory for long-term persistence across sessionsIntelligent management: Uses keyword matching and LLM-powered decision making to automatically determine whether to create new memories or update existing ones
Automatic validation: Validates content size and relevance before storage to maintain memory quality
Context preservation: Prevents duplicate work and knowledge loss by maintaining a growing repository of project knowledge that Claude can reference across conversations
Click on "Install 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 MCPrecall what we discussed about the authentication system"
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.
English | 简体中文
Memory MCP
An MCP server that provides project memory management for Claude Code.
Quick Start
Prerequisites
Python >= 3.10
uv package manager
Anthropic API Key (get it from Anthropic Console)
Option 1: Install via CLI (Recommended)
Install directly from GitHub (no download required):
# Add to current project (local scope)
claude mcp add memory \
--env ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
-- uvx --from git+https://github.com/JerryZhongJ/memory-mcp.git memory-mcp --project $(pwd)Option 2: Local Development Installation
If you need to modify the source code or contribute to development:
# 1. Clone the repository
git clone https://github.com/JerryZhongJ/memory-mcp.git
cd memory-mcp
# 2. Install dependencies
uv sync
# 3. Add to Claude Code
claude mcp add memory \
--env ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
-- uv --directory /path/to/memory-mcp run memory-mcp --project $(pwd)Verify Installation
After configuration, Claude Code will automatically load the server. You can verify with:
# List all configured MCP servers
claude mcp list
# Use /mcp command in Claude Code to check server statusManage Server
# Remove server
claude mcp remove memory
# View server details
claude mcp get memoryHow It Works
Memories are stored as Markdown files in the project's
.memoriesdirectoryUses intelligent keyword matching and retrieval
LLM automatically decides whether to create new memories or update existing ones
Automatically validates content size and relevance
Frontend-backend separation architecture with automatic backend lifecycle management
Configuring CLAUDE.md
To help Claude better use this MCP service, it's recommended to create a .claude/CLAUDE.md file in your project with the following usage rules:
# Project Memory Management Rules
## ⚠️ Mandatory Rules (Must Be Strictly Followed)
### 1. Query Memory Before Starting Tasks
**Every time you receive a user question, the first step must be to use `recall_memory_tool` to query relevant information.**
Do not rely on judgment to decide whether to query. Any question may be related to existing memories.
### 2. Save New Information Immediately Upon Discovery
**Whenever you obtain valuable new information through investigation, you must immediately use `memorize_memory_tool` to save it.**
Save the information as soon as you discover it, don't wait until after answering the user's question.
**Standard Workflow**:
```
User Question → Query Memory → Investigate Code/Docs → Discover New Info → Save Immediately → Answer User
```
**Important**: Skipping these steps leads to duplicate work, inconsistent answers, and knowledge loss.License
MIT