Simple Memory

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

Setup

bun install

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