Skip to content
MCP server

CtxVault

Local vaults of semantic, skill and episodic memory for AI agents, kept as folders on disk

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Linux
Runs
Locally
Version
0.9.1
Listing updated
3 days ago

About CtxVault

CtxVault is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add ctxvault -- uvx ctxvault

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ctxvault": {
      "command": "uvx",
      "args": [
        "ctxvault"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ctxvault": {
      "command": "uvx",
      "args": [
        "ctxvault"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Open source

MIT licensed, runs locally

Prices change. Check filippo-venturini.github.io before you buy.

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 to CtxVault

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity