# VelesDB Memory

> VelesDB Memory is an MCP server for knowledge and memory. Local agent memory server with remember, recall, relate, forget and why over one engine. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** macOS, Windows, Linux, CLI, self-hosted
- **Repository:** https://github.com/cyberlife-coder/velesdb
- **MCP Registry name:** io.github.cyberlife-coder/velesdb-memory
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-18

## About

Memory lives in a single local engine that fuses vector search, a graph and columnar storage, so one store can answer similarity questions and relationship questions together. The README says no LLM and no API key sit in the memory path, and data stays on the machine. The only outbound call is an opt-out version check that sends version, edition, OS, architecture and a hashed install id.

The registry lists five operations: remember, recall, relate, forget and why. The last one is the notable piece: the README describes a memory that shows its evidence rather than returning bare matches. Prebuilt `.mcpb` bundles are published for Apple Silicon and Intel macOS, Windows x64 and Linux on x86_64 and ARM, and the server runs over stdio.

A guided installer detects installed clients (Claude Code, Codex, Cursor, Cline, Zed, OpenCode, Claude Desktop, Windsurf and others), picks single-client stdio or a shared local daemon, and can set up optional hooks that load and save working context and require a recall before an edit. Embeddings can come from a local Ollama model; the embedding dimension is fixed per store.

## Features

- **Fused vector, graph and columns:** One binary of about 14 MB combines three storage models under a single query language.
- **Evidence-backed recall:** The why operation explains where a remembered item came from.
- **Local-first:** No LLM or API key is used in the memory path and data is not sent out.
- **Guided installer:** A wizard detects supported clients, checks checksums and rewires configs with backups.
- **Optional agent hooks:** Six Claude Code hooks save working context and can require recall before edits.
- **Shared local daemon:** One memory can serve several clients over local HTTPS.

## Good for

- Give a coding agent persistent memory across sessions
- Share one memory between Claude Code and Cursor on one machine
- Keep related facts linked so an agent can recall them by relationship
- Run agent memory offline with a local embedding model

## Install

### Claude Code (Terminal)

```sh
claude mcp add velesdb-memory -- npx -y https://github.com/cyberlife-coder/VelesDB/releases/download/velesdb-memory-v0.17.1/velesdb-memory-0.17.1-aarch64-apple-darwin.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "velesdb-memory": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/cyberlife-coder/VelesDB/releases/download/velesdb-memory-v0.17.1/velesdb-memory-0.17.1-aarch64-apple-darwin.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "velesdb-memory": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/cyberlife-coder/VelesDB/releases/download/velesdb-memory-v0.17.1/velesdb-memory-0.17.1-aarch64-apple-darwin.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "velesdb-memory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/cyberlife-coder/VelesDB/releases/download/velesdb-memory-v0.17.1/velesdb-memory-0.17.1-aarch64-apple-darwin.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "velesdb-memory": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/cyberlife-coder/VelesDB/releases/download/velesdb-memory-v0.17.1/velesdb-memory-0.17.1-aarch64-apple-darwin.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "velesdb-memory": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/cyberlife-coder/VelesDB/releases/download/velesdb-memory-v0.17.1/velesdb-memory-0.17.1-aarch64-apple-darwin.mcpb"
      ]
    }
  }
}
```

## Tools

- `remember`: Stores an item in the agent memory.
- `recall`: Retrieves stored items relevant to a query.
- `relate`: Links stored items to each other in the graph.
- `forget`: Removes stored items from memory.
- `why`: Shows the evidence behind a recalled item.

## FAQ

### Does it send my data anywhere?

The README says data never leaves the machine; the only outbound call is an opt-out version check with no stored data.

### Which platforms have prebuilt bundles?

macOS on Apple Silicon and Intel, Windows x64, and Linux on x86_64 and ARM.

### Can I install it without Rust?

Yes, via a prebuilt .mcpb bundle or the npm package @wiscale/velesdb-memory-node.

### What is the embedding dimension tied to?

The embedding model; it is fixed when the store is created, and changing it needs a re-embed.

### How do I add VelesDB Memory to Claude Code?

Run this command in your terminal: claude mcp add velesdb-memory -- npx -y https://github.com/cyberlife-coder/VelesDB/releases/download/velesdb-memory-v0.17.1/velesdb-memory-0.17.1-aarch64-apple-darwin.mcpb

### What are the best alternatives to VelesDB Memory?

The closest alternatives to VelesDB Memory are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and NeuroStack.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [NeuroStack](https://ai-powered.com/mcp/neurostack): NeuroStack is a freemium MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Digitalnz](https://ai-powered.com/mcp/digitalnz): Digitalnz is a freemium MCP server for knowledge and memory.
- [Notion_connect](https://ai-powered.com/mcp/notion-connect): Notion_connect is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/velesdb-memory
