# memory-vault

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 121 installs
- Author: ndpsoftware
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/ndpsoftware/memory-vault
- Updated: 2026-06-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/ndpsoftware-memory-vault

## What it 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.

## Requirements
- Remote server: `https://memory-vault--ndpsoftware.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http memory-vault https://memory-vault--ndpsoftware.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add ndpsoftware-memory-vault --url https://memory-vault--ndpsoftware.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ndpsoftware-memory-vault": {
            "url": "https://memory-vault--ndpsoftware.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ndpsoftware-memory-vault": {
            "type": "http",
            "url": "https://memory-vault--ndpsoftware.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http ndpsoftware-memory-vault https://memory-vault--ndpsoftware.run.tools
```

## When to use it
- 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
- 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-meta` and `last-run-stats`."
- In a loop: "After each commit, check `usage`; if quota is below 20%, delete cached entries older than one week."

## Similar
- [TmpState](https://affpapa.org/en/nevibecode/mcp/tmpstate.md) — MCP server · 493 installs
- [agentdb-persistent-memory-patterns](https://affpapa.org/en/nevibecode/skills/agentdb-persistent-memory-patterns.md) — skill · 1 install
- [memory-management](https://affpapa.org/en/nevibecode/skills/zcf0508-memory-management.md) — skill · 1 install
- [context-memory](https://affpapa.org/en/nevibecode/plugins/context-memory.md) — plugin · ★ 1013 repo stars
- [c-memory](https://affpapa.org/en/nevibecode/skills/c-memory.md) — skill · ★ 179 repo stars
- [Memory Vault](https://affpapa.org/en/nevibecode/mcp/memory-vault.md) — MCP server · ★ 67 repo stars

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