CtxVault
Local vaults of semantic, skill and episodic memory for AI agents, kept as folders on disk
- 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 ctxvaultAdd to claude_desktop_config.json
{
"mcpServers": {
"ctxvault": {
"command": "uvx",
"args": [
"ctxvault"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ctxvault": {
"command": "uvx",
"args": [
"ctxvault"
]
}
}
}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

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP 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

Nautilus Compass Memory
MCP serverLocal-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

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity
MedXpert 图书馆连接器(通用版)
MCP serverLocal MCP server that searches and answers questions over your own Markdown wiki
Runs locally- 4 tools
- Open source
- Knowledge and memory