# CtxVault

CtxVault — an MCP server for Claude Code that stores agent memory in separate local vaults. It supports semantic search, procedural instructions and time-aware records.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 70 repo stars
- Author: Filippo-Venturini
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Filippo-Venturini/ctxvault
- Updated: 2026-11-10
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/ctxvault

## What it does

CtxVault keeps an agent’s knowledge, procedures and episodic facts in separate local vaults. Documents in semantic vaults are indexed for meaning-based retrieval; procedures are stored as Markdown, while episodic records track when a fact was valid and when it entered the vault.

Each vault has its own directory, and access to restricted vaults can be assigned to specific agents. The files remain readable and editable on disk. Installing through the Claude Code command requires `uvx`.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add ctxvault -- uvx ctxvault
```
uvx runs the command named after the package; if the README names another one, use uvx --from ctxvault <command>

### Codex

**Platform CLI**
```bash
codex mcp add ctxvault -- uvx ctxvault
```
uvx runs the command named after the package; if the README names another one, use uvx --from ctxvault <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ctxvault": {
            "command": "uvx",
            "args": [
                "ctxvault"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from ctxvault <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ctxvault": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "ctxvault"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from ctxvault <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add ctxvault uvx ctxvault
```
uvx runs the command named after the package; if the README names another one, use uvx --from ctxvault <command>

## When to use it
- retrieve a document by meaning rather than exact wording
- keep agent procedures apart from stored knowledge
- preserve facts across sessions with time context

## Example prompts
- Find the architecture decision stored in memory.
- Save this instruction as an agent skill.
- What do we know about events that were true last week?

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
