Why does the `--config` path have to be absolute?

Claude Code does not guarantee the working directory it spawns the server in. An absolute `--config` path ensures that the database, capture directory, and tree root anchor to that file regardless of where the server is launched.

Does Mnemos require a vector database or external services?

No. Mnemos uses SQLite FTS5 and BM25 for default lexical search. No vector database, Ollama, Python, or Node service is needed.

SSyncDev

Start a project

Mnemos MCP Server

Local-first MCP memory server for AI agents, with source citations and OKF/Markdown knowledge bases.

Local serverstdioPython

What is the Mnemos MCP Server?

Local-first MCP memory server for AI agents, with source citations and OKF/Markdown knowledge bases.

What the server does

Claude Code is powerful, but it forgets your project context:

Truly local-first — runs entirely on your machine. No network, no telemetry, no data leaves your project
Zero dependencies — one self-contained, cgo-free Go binary. No Python, Docker, Qdrant, or Ollama
Any MCP client — built for Claude Code, works with anything that speaks MCP
Cited answers — every result links back to the exact file#section and line range, so claims are verifiable
Fast search by default — SQLite FTS5 / bm25 out of the box; optional local semantic + hybrid search behind a build tag
Read-write memory — the agent can capture durable notes (remember); you can manage the tree (forget, move, list)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Mnemos MCP Server

{
  "mcpServers": {
    "mnemos": {
      "command": "mnemos",
      "args": [
        "serve",
        "--config",
        "/abs/path/to/project/.mnemos/mnemos.toml"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

“Use Mnemos to Read.”
“Use Mnemos to Retriever.”
“Use Mnemos to Hook.”

Frequently asked questions

A document’s identity is its path relative to the scan root you ingested (e.g., `docs`). If two ingested directories each contain a file with the same relative path, the second ingest silently overwrites the first.