# Memory MCP

> Memory MCP is an open-source MCP server for knowledge and memory. Persistent memory MCP server that saves and recalls Claude Code conversation history. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/chenxiaofie/memory-mcp
- **MCP Registry name:** io.github.chenxiaofie/memory-mcp
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-18

## About

The README says the service stores Claude Code conversations as episodes, with auto-generated summaries when a session closes. Key knowledge such as decisions, preferences and architecture notes can be pulled out as separate entities and searched later by meaning rather than exact keywords.

Hooks for session start, user prompts, assistant replies and session end handle saving and recall automatically, so relevant past context can be injected into new sessions. Memory is kept in two layers: user-level storage shared across projects and project-level storage isolated per project directory.

It suits developers who work with Claude Code over many sessions and want decisions and context to carry forward. The vector model is roughly 400MB to download on first setup, and the README notes Python 3.10 to 3.13 is required.

## Features

- **Episode-based session memory:** Each conversation session is stored as an episode with an automatically generated summary.
- **Entity extraction:** Decisions, preferences, concepts and files can be recorded as typed knowledge entities.
- **Semantic recall:** Vector-based search retrieves related past episodes and entities for the current task.
- **Automatic hooks:** Session and message hooks save context and inject relevant history without manual calls.
- **Dual-layer storage:** User-level memory is shared across projects while project-level memory stays isolated.

## Good for

- Keep architecture decisions available across weeks of Claude Code sessions
- Recall personal coding preferences without restating them each session
- Resume a feature in a new session with the earlier discussion as context
- Track important project files and their purpose over time

## Install

### Claude Code (Terminal)

```sh
claude mcp add memory-mcp -- uvx chenxiaofie-memory-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "memory-mcp": {
      "command": "uvx",
      "args": [
        "chenxiaofie-memory-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "memory-mcp": {
      "command": "uvx",
      "args": [
        "chenxiaofie-memory-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "memory-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "chenxiaofie-memory-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "memory-mcp": {
      "command": "uvx",
      "args": [
        "chenxiaofie-memory-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "memory-mcp": {
      "command": "uvx",
      "args": [
        "chenxiaofie-memory-mcp"
      ]
    }
  }
}
```

## FAQ

### What license is it released under?

The README states the project is under the MIT License.

### What Python versions are required?

The README says Python 3.10 to 3.13 is required, as chromadb is not compatible with Python 3.14 or later.

### How do I install it for Claude Code?

The README gives a command using uvx to add the server with claude mcp add, plus optional hooks configured in settings.json.

### Is Memory MCP free?

Yes. Memory MCP is open source, so you can use and self-host it for free.

### How do I add Memory MCP to Claude Code?

Run this command in your terminal: claude mcp add memory-mcp -- uvx chenxiaofie-memory-mcp

### What are the best alternatives to Memory MCP?

The closest alternatives to Memory MCP are cogito-mem (Cogi), Hypermnesia MCP, Memory Vault, CogniCore and ContextStream MCP Server.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [cogito-mem (Cogi)](https://ai-powered.com/mcp/cogito-mem-cogi): cogito-mem (Cogi) is a free MCP server for knowledge and memory.
- [Hypermnesia MCP](https://ai-powered.com/mcp/hypermnesia-mcp): Hypermnesia MCP is an open-source MCP server for knowledge and memory.
- [Memory Vault](https://ai-powered.com/mcp/memory-vault): Memory Vault is an open-source MCP server for knowledge and memory.
- [CogniCore](https://ai-powered.com/mcp/cognicore): CogniCore is an open-source MCP server for knowledge and memory.
- [ContextStream MCP Server](https://ai-powered.com/mcp/contextstream-mcp-server): ContextStream MCP Server is a freemium MCP server for knowledge and memory.
- [Memro](https://ai-powered.com/mcp/memro): Memro is a freemium MCP server for developer tools.
- [Crbro Memory](https://ai-powered.com/mcp/crbro-memory): Crbro Memory is an open-source MCP server for knowledge and memory.
- [Empirical](https://ai-powered.com/mcp/empirical): Empirical is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/memory-mcp-2
