simple-memory-mcp

Personal memory MCP server backed by SQLite FTS5 BM25 search with temporal reranking.

Setup

bun install

Related MCP server: Hoard

Run

bun run start

The server uses stdio transport and creates memory.db in the project root.

Run From GitHub With bunx

bunx --bun github:mrorigo/simple-memory-mcp#main

Because of the bin entry, this starts the simple-memory-mcp CLI directly.

For MCP client configuration (example):

{
  "mcpServers": {
    "simple_memory": {
      "command": "bunx",
      "args": ["--bun", "github:mrorigo/simple=memory-mcp#main"]
    }
  }
}

Tools

• ingest_document

  • Inputs: filename (string path to a UTF-8 text file)

• search_memory

  • Inputs: query (string), limit (optional number, default 5, max 50)

  • Ranking: |bm25| * (1 / (1 + 0.05 * ageInDays))

• scrub_document

  • Inputs: filename (string path/identifier as stored in memory)

  • Behavior: removes all matching records from the memory database only; does not delete or modify files on disk.

Verify

bun test
bun run typecheck
bun run smoke