# mcp-memory-rs

> mcp-memory-rs is an open-source MCP server for knowledge and memory. Local-first persistent memory server for AI agents, stored as plain JSON and SQLite. It is available on Linux, macOS, API, CLI and self-hosted.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Linux, macOS, API, CLI, self-hosted
- **Website:** https://dev.mmmbuto.com
- **Repository:** https://github.com/dionanos/mcp-memory-rs
- **MCP Registry name:** io.github.DioNanos/mcp-memory-rs
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory), [agent tooling](https://ai-powered.com/categories/agent-tooling)
- **Listing updated:** 2026-11-18

## About

The README describes mcp-memory-rs as a Rust MCP server that keeps an agent's long-lived state on the user's own disk. Each memory category is a JSON file backed by a SQLite FTS5 index, and every write is versioned with a backup taken before deletes. Files are the source of truth, so the database can be rebuilt from them and the state can be read, diffed and backed up with ordinary tools.

Multiple devices can share memory through an optional HTTP sync endpoint that uses merkle manifests and optimistic concurrency. The stdio server runs offline by default, and the README notes that sync is a separate, explicit step. A per-device ACL governs writes on the MCP stdio surface, while the HTTP API is documented as an admin plane gated by a single bearer token.

The project is aimed at people running AI coding clients such as Claude Code or Codex who want the same memory to survive a model or vendor change. Search uses BM25 without embedding models, and the companion server mcp-vl-msa-rs handles chunked corpus retrieval.

## Features

- **Versioned JSON categories:** Each category is stored as a JSON file with write history and automatic backups before overwrites and deletes.
- **BM25 full-text search:** Category search runs on SQLite FTS5 with BM25 ranking and category, date and actor filters.
- **Per-device write ACL:** Admin devices can write everything, while other devices are limited to their own category namespace on the stdio surface.
- **Fleet sync over HTTP:** Nodes exchange merkle-rooted manifests and push or pull dirty categories through an optional bearer-token endpoint.
- **Snapshot and restore CLI:** Built-in commands create verified snapshots, restore stores and check consistency between the database and JSON files.

## Good for

- Give a coding agent persistent project and infrastructure notes that survive switching between MCP clients
- Keep per-device workflow state separate across several laptops or servers
- Sync agent memory between machines through a loopback endpoint tunnelled between nodes
- Back up and restore an agent's memory store without copying the live database by hand

## Tools

- `memory_read`: Read a category, with optional field filtering.
- `memory_write`: Replace or merge-patch a category; versioned with an expected_hash precondition.
- `memory_append`: Append a timestamped entry to a bounded append-only log category.
- `memory_delete`: Delete a category after creating a backup.
- `memory_list`: List all categories with hash, size and update metadata.
- `memory_search`: Run FTS5 full-text search with BM25 ranking and filters.
- `memory_search_semantic`: Run hybrid TF-IDF and FTS5 search.
- `memory_history`: Show the version history of a category.
- `memory_delta`: List changes since a known hash.
- `memory_context`: Read multiple categories in one token-budgeted call.
- `memory_compact`: Prune old versions and backups.
- `memory_status`: Show dirty queue, manifest hash and last sync.
- `memory_doctor`: Run diagnostics on paths, database, categories and sync config.
- `sync_manifest`: Build a merkle-rooted manifest of all categories.
- `sync_diff`: Compare local and remote manifests.
- `sync_push`: Export sync envelopes.
- `sync_pull`: Import sync envelopes.
- `memory_sync`: Run one sync step against the configured remote.

## FAQ

### Does it need a cloud account or embedding service?

The README says no cloud account, embedding service or network dependency is needed in the default offline mode. Semantic search is an optional TF-IDF hybrid, and no model downloads are required.

### Which MCP clients does it work with?

The README names Claude Code and Codex and says any client that speaks MCP over stdio can use it.

### Is the HTTP sync API restricted per device?

No. The README states that HTTP callers are identified only by the shared token, so per-device ACL is not enforced on the HTTP API.

### Which platforms have prebuilt binaries?

The README lists prebuilt Linux x86_64 and aarch64 builds (glibc and musl) and an aarch64 Android target. macOS users are told to build from source with cargo install.

### Is mcp-memory-rs free?

Yes. mcp-memory-rs is open source, so you can use and self-host it for free.

### What are the best alternatives to mcp-memory-rs?

The closest alternatives to mcp-memory-rs are MCP Memory, mcp-vl-msa-rs, Agent Memory MCP, Cross-Agent Memory and Holographic Memory.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.

## Alternatives

- [MCP Memory](https://ai-powered.com/mcp/mcp-memory): MCP Memory is an open-source MCP server for knowledge and memory.
- [mcp-vl-msa-rs](https://ai-powered.com/mcp/mcp-vl-msa-rs): mcp-vl-msa-rs is an open-source MCP server for knowledge and memory.
- [Agent Memory MCP](https://ai-powered.com/mcp/agent-memory-mcp): Agent Memory MCP is an open-source MCP server for knowledge and memory.
- [Cross-Agent Memory](https://ai-powered.com/mcp/cross-agent-memory): Cross-Agent Memory is an open-source MCP server for knowledge and memory.
- [Holographic Memory](https://ai-powered.com/mcp/holographic-memory): Holographic Memory is an open-source MCP server for knowledge and memory.
- [Compound Memory](https://ai-powered.com/mcp/compound-memory): Compound Memory is an open-source MCP server for knowledge and memory.
- [State Memory MCP](https://ai-powered.com/mcp/state-memory-mcp): State Memory MCP is an open-source MCP server for knowledge and memory.
- [MCP Server](https://ai-powered.com/mcp/mcp-server-mwep25fw): MCP Server is a paid MCP server for databases.

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