Skip to main content
Glama

English | 简体中文

Memory MCP

An MCP server that provides project memory management for Claude Code.

Quick Start

Prerequisites

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 status

Manage Server

# Remove server
claude mcp remove memory

# View server details
claude mcp get memory

Related MCP server: Chronos MCP

How It Works

  • Memories are stored as Markdown files in the project's .memories directory

  • Uses 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 tools
memorize_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

    B3.1/5.0

    Scored across 2 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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
    • A
      license
      Not graded
      quality
      D
      maintenance
      Cross-project memory for Claude Code, enabling local semantic recall and secure, git-versioned markdown storage of reusable knowledge across repositories.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides persistent long-term memory and local RAG document search for Claude Desktop, fully offline. Enables memory save/search and document retrieval via MCP.
      MIT