CtxVault — Claude Code MCP server: memory and setup
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.
MIT ★ 70 updated 2026-11-10
claude mcp add ctxvault -- uvx ctxvaultWhat CtxVault 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.
What it helps with
- 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 for the agent
- 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?
How to install CtxVault
Platform CLI
claude mcp add ctxvault -- uvx ctxvaultuvx runs the command named after the package; if the README names another one, use uvx --from ctxvault <command>
Platform CLI
codex mcp add ctxvault -- uvx ctxvaultuvx runs the command named after the package; if the README names another one, use uvx --from ctxvault <command>
Config file
{
"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>
Config file
{
"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>
Platform CLI
gemini mcp add ctxvault uvx ctxvaultuvx runs the command named after the package; if the README names another one, use uvx --from ctxvault <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about CtxVault
How do I install CtxVault in Claude Code?
Run claude mcp add ctxvault -- uvx ctxvault.
What does CtxVault do?
It provides local memory for AI agents, separating knowledge, procedures and episodic facts into distinct vaults.
What does CtxVault need to run?
The Claude Code install command uses uvx: claude mcp add ctxvault -- uvx ctxvault.