# MemVault - Local-First Agent Memory

> MemVault - Local-First Agent Memory is an open-source MCP server for knowledge and memory. Local-first shared memory layer that any MCP client can save to and recall from. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, self-hosted, Web
- **Repository:** https://github.com/dreamor/memvault
- **MCP Registry name:** io.github.dreamor/memvault
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-15

## About

MemVault is a self-hosted router that keeps memories outside any one agent, so Claude Desktop, Cursor, Cline or other MCP clients share the same context. The README frames the idea as memory finding the agent: when a client connects, relevant stored items are injected as context, and entries marked MUST priority are injected as instructions the agent should follow.

A companion CLI saves, searches and lists memories, extracts structured items from free text, records task outcomes with lessons, deduplicates, decays and archives stale entries, and can generate agent instruction files from memory. Retrieval is hybrid keyword plus semantic when embeddings are enabled. It auto-detects a local Ollama for embeddings and LLM extraction, so it can run fully on your machine.

It is written in Rust and MIT licensed. Prebuilt Linux binaries need a recent glibc (2.39 or later); older systems are pointed to the Docker image or a source build. A local dashboard is started with memvault-cli dashboard.

## Features

- **Shared across agents:** Any MCP client connecting to it sees the same memory.
- **Priority levels:** MUST-level preferences are injected as instructions.
- **Hybrid retrieval:** Keyword search plus semantic search when embeddings are on.
- **Local Ollama support:** Embeddings and extraction can run on a local Ollama model.
- **Dedup and decay:** Commands to dedupe, decay and archive stale memories.
- **Instruction file sync:** A sync command generates agent instruction files from memory.

## Good for

- Keep coding preferences consistent across Claude Code and Cursor
- Record lessons from failed deployments for later sessions
- Extract memories from free text notes
- Run agent memory entirely on a local machine

## Install

### Claude Code (Terminal)

```sh
claude mcp add memvault -- docker run -i --rm ghcr.io/dreamor/memvault:v0.7.2
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "memvault": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/dreamor/memvault:v0.7.2"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "memvault": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/dreamor/memvault:v0.7.2"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "memvault": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/dreamor/memvault:v0.7.2"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "memvault": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/dreamor/memvault:v0.7.2"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "memvault": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/dreamor/memvault:v0.7.2"
      ]
    }
  }
}
```

## FAQ

### Is it open source?

Yes, the README states MIT licence and self-hosted.

### How is it installed?

Via an install script, Homebrew, cargo install, or the Docker image.

### Does it need a cloud service?

No. Embeddings and extraction can use a local Ollama.

### What are the Linux requirements for prebuilt binaries?

glibc 2.39 or later; older distributions should use Docker or build from source.

### Is MemVault - Local-First Agent Memory free?

Yes. MemVault - Local-First Agent Memory is open source, so you can use and self-host it for free.

### How do I add MemVault - Local-First Agent Memory to Claude Code?

Run this command in your terminal: claude mcp add memvault -- docker run -i --rm ghcr.io/dreamor/memvault:v0.7.2

### What are the best alternatives to MemVault - Local-First Agent Memory?

The closest alternatives to MemVault - Local-First Agent Memory are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/memvault-local-first-agent-memory
