# CtxVault

> CtxVault is an open-source MCP server for knowledge and memory. Local vaults of semantic, skill and episodic memory for AI agents, kept as folders on disk. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux, macOS, Windows
- **Website:** https://filippo-venturini.github.io/ctxvault/
- **Repository:** https://github.com/filippo-venturini/ctxvault
- **MCP Registry name:** io.github.Filippo-Venturini/ctxvault
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-14

## About

CtxVault argues that most agent memory is one shared vector index where isolation depends on configuration staying right. Its alternative is the vault: a directory-backed unit with a type. Semantic vaults hold documents (PDF, DOCX, Markdown, text) chunked and embedded locally; skill vaults hold named Markdown procedures the agent lists and reads; episodic vaults hold statements with two timelines, when they were true and when the vault learned them.

Each vault is its own index, and restricted vaults answer only the agents attached to them through the CLI. Everything lives in plain directories, with a CLI and a memory viewer that maps every vault and offers a time cursor on episodic ones.

There is no cloud or telemetry. Use it in-process from Python, over HTTP, or through the stdio MCP server from the PyPI package. It is MIT licensed.

## Features

- **Typed vaults:** Semantic, skill and episodic memory kept apart.
- **Structural isolation:** Each vault is its own index; restricted vaults answer only attached agents.
- **Time-aware memory:** Episodic vaults can be queried as of any past instant.
- **Plain folders:** Vaults are directories you can inspect.
- **Memory viewer:** Map of vaults with a time cursor for episodic ones.
- **Fully local:** No cloud and no telemetry.

## Good for

- Give each agent in a team its own private memory
- Share one document knowledge base across agents
- Store reusable procedures for a specific agent role
- Track facts that change over time
- Keep context between sessions in Claude Desktop

## Install

### Claude Code (Terminal)

```sh
claude mcp add ctxvault -- uvx ctxvault
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ctxvault": {
      "command": "uvx",
      "args": [
        "ctxvault"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ctxvault": {
      "command": "uvx",
      "args": [
        "ctxvault"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "ctxvault": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ctxvault"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ctxvault": {
      "command": "uvx",
      "args": [
        "ctxvault"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ctxvault": {
      "command": "uvx",
      "args": [
        "ctxvault"
      ]
    }
  }
}
```

## FAQ

### Does any data leave my machine?

The site says there is no cloud and no telemetry.

### What file types go in semantic vaults?

PDF, DOCX, Markdown and text.

### How do I restrict a vault?

Declare it restricted and grant specific agents access through the CLI.

### What licence is it?

MIT.

### Is CtxVault free?

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

### How do I add CtxVault to Claude Code?

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

### What are the best alternatives to CtxVault?

The closest alternatives to CtxVault 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/ctxvault
