Memkeeper MCP server

Most software has the memory of a goldfish. This one doesn’t.

memkeeper

Local-first memory for AI agents. A fast, embeddable memory engine that stores, ranks, and retrieves an agent's durable context, entirely on your machine, with no required network or LLM calls.

Memkeeper is the open-source, local-first control plane that AI agents run on: durable memory, project context, coordinated task handoffs, and deny-by-default permissions, all deterministic and on your own machine. This repo is the memory engine at its core.

ℹ️ Generated release mirror. This repo is generated from a private

development repo and published as releases. The main branch may be

regenerated, so pin to tagged releases (or the release artifacts) rather

than to arbitrary main commits — tagged releases are stable. See

CONTRIBUTING.md for how to contribute; issues, security

reports, and design feedback are the best paths today.

semantic embeddings and a cross-encoder reranker.

• Local-first. A single SQLite database. No server, no cloud, no telemetry.
• Fast at prompt time. Deterministic BM25/FTS retrieval with optional ONNX

retention model that promotes recurring, high-signal memories to a durable tier.

• Durable by design. Atomic writes, schema-versioned storage, and a

Real CLI output, formatted for readability via scripts/mkfmt. The search query shares no keywords with the memory it surfaces.

Status: pre-release (v0.5.3). APIs and the wire protocol may change before 1.0.

Quickstart

# Install the latest release binary (macOS arm64 / Linux x86_64) to ~/.local/bin.
# It's self-contained — nothing else to install.
curl -fsSL https://raw.githubusercontent.com/teflon07/memkeeper/main/install.sh | bash

# Optional, one-time: fetch on-device semantic models. Lexical search works without it.
memkeeper pull-models

# Create a store, remember something, search it back.
memkeeper init
memkeeper remember --json '{"content":"memkeeper stores memories in a local SQLite database"}'
memkeeper search   --json '{"query":"where are memories stored","limit":3}'

That's the whole install: a self-contained binary, no runtime network/LLM/API key. Prefer not to pipe a script to your shell? Grab a binary from the releases page and verify its .sha256, or build from source. The store defaults to ~/.memkeeper/store.sqlite when --store is omitted; a --json value can also be @ or - (stdin) instead of an inline string, which avoids shell-quoting pitfalls (handy in Windows PowerShell).

Upgrade from v0.2.x

Shortened. The full README is on GitHub.