memory-vault — Claude Code MCP server: persistent JSON storage
memory-vault — an MCP server for Claude Code, Cursor, and other IDEs that gives agents a key-value store with predictable quotas. Keeps context and state across sessions so the agent remembers where it left off.
no license 121 installs updated 2026-06-01
claude mcp add --transport http memory-vault https://memory-vault--ndpsoftware.run.toolsWhat memory-vault does
memory-vault runs on Claude Code, Codex, Cursor, GitHub Copilot, Windsurf, Cline, Zed, and Gemini CLI. It exposes four tools: store writes a JSON value under a key, retrieve fetches it back, delete removes it, and usage reports quota consumption. The API is deterministic—the same key always returns the same value, so an agent's state does not drift between runs.
Persistence means an agent can save progress (a parsing state, a task list, cached results) and reload it in a later session without needing local files. Quotas are predictable, so the agent knows when to clean up old data. The endpoint https://memory-vault--ndpsoftware.run.tools is a simple HTTP API exposed via MCP.
What it helps with
- preserve agent context across IDE sessions
- cache query results without writing to disk
- track project state over time
- share data between multiple agents working on the same codebase
Example prompts for the agent
- Tell the agent: "Before ending this session, store the current parsing state under key
parser-checkpoint; restore it next time." - In a system prompt: "Before discarding context, save critical config and metrics to keys like
project-metaandlast-run-stats." - In a loop: "After each commit, check
usage; if quota is below 20%, delete cached entries older than one week."
How to install memory-vault
Platform CLI: remote server
claude mcp add --transport http memory-vault https://memory-vault--ndpsoftware.run.toolsPlatform CLI: remote server
codex mcp add ndpsoftware-memory-vault --url https://memory-vault--ndpsoftware.run.toolsConfig file
{
"mcpServers": {
"ndpsoftware-memory-vault": {
"url": "https://memory-vault--ndpsoftware.run.tools"
}
}
}Config file
{
"servers": {
"ndpsoftware-memory-vault": {
"type": "http",
"url": "https://memory-vault--ndpsoftware.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http ndpsoftware-memory-vault https://memory-vault--ndpsoftware.run.toolsStep 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 memory-vault
How do I install memory-vault in Claude Code?
Run claude mcp add --transport http memory-vault https://memory-vault--ndpsoftware.run.tools. The agent can then call the storage tools. To use a specific server name, use claude mcp add --transport http ndpsoftware-memory-vault https://memory-vault--ndpsoftware.run.tools.
What does memory-vault do?
It is a service for storing and retrieving JSON with predictable quota limits. An agent can write a value under a key, fetch it later, delete it, or check current quota usage. Data persists between sessions.
What tools does it expose?
Four: store writes JSON values, retrieve fetches them by key, delete removes a key-value pair, and usage displays quota and consumption.