Memory MCP
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 "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 MCP recall 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 memoryRelated MCP server: Chronos MCP
How 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
Available Tools
2 toolsmemorize_memory_toolC
记住一些内容
Args:
content: 要记住的内容。可以是一句话、一段文字甚至更长的文本。
Inputs: content (required). Returns: result
recall_memory_toolC
从项目记忆中回忆相关信息
Args:
interest: 想要回忆的任何东西,可以是一句陈述、一个问题甚至是关键词
Inputs: interest (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have completely distinct purposes: one stores information (memorize) and one retrieves information (recall). There is no overlap in functionality, and an agent would never confuse which tool to use for which operation.
Both tools follow the same verb_noun_tool pattern: memorize_memory_tool and recall_memory_tool. The naming is perfectly consistent with clear action verbs and matching structure throughout.
With only 2 tools, this server feels thin for a memory system. While memorize and recall cover basic operations, there are no tools for managing, organizing, updating, or deleting memories, which would be expected for a complete memory management system.
The tool surface is severely incomplete for a memory system. While it covers basic store and retrieve operations, there are no tools for updating existing memories, deleting memories, listing available memories, searching with filters, or managing memory organization. This creates significant gaps that will limit agent effectiveness.
Maintenance
Related MCP Connectors
Project memory, documentation and controlled secret access for AI coding agents.
Persistent memory for Claude Code and Cursor. Stop re-explaining your project every session.
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
Persistent AI memory shared across Claude, ChatGPT, coding agents, and compatible MCP clients.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI assistants to maintain persistent project context across sessions by storing and retrieving structured information in markdown files organized in a memory bank directory.457Apache 2.0
- AlicenseNot gradedqualityDmaintenanceProvides Claude with a persistent local memory and structured knowledge graph to track project states, tasks, and historical decisions across different chat sessions. It enables users to recall information using keyword relevance, time-travel queries, and dependency analysis for complex project management.MIT
- AlicenseNot gradedqualityDmaintenanceCross-project memory for Claude Code, enabling local semantic recall and secure, git-versioned markdown storage of reusable knowledge across repositories.MIT
- AlicenseNot gradedqualityBmaintenanceProvides persistent long-term memory and local RAG document search for Claude Desktop, fully offline. Enables memory save/search and document retrieval via MCP.MIT