Skip to content

MuninnLong-term memory for AI assistants

An MCP server in one static Rust binary. Hybrid search, a knowledge graph and safe writes over a folder of Markdown notes you can open in any editor.

The letter M drawn as a graph of linked notes

Ask in plain words, get your own notes back โ€‹

Your assistant forgets everything when the conversation ends. Muninn gives it somewhere to write things down, and a way to find them again by meaning, not only by the words you happened to use.

The conversation โ€‹

text
you   โ–ธ How strong should the coffee be?
model โ–ธ mem_search
        { "query": "how strong should
          the coffee be?" }
      โ†’ food/coffee-brewing.md ยงMethod
        [ratio] 1:16 coffee to water
model โ–ธ Your note says 1:16 by
        weight, adjusted for the roast.

The note it found โ€‹

markdown
---
title: Coffee brewing
tags: [coffee]
---

# Coffee brewing

## Method
- [method] Pour-over: a cleaner cup #brewing
- [ratio] 1:16 coffee to water

## Related
- relates_to [[Coffee beans]]

Running in a minute โ€‹

One container, one folder of notes. Add an embedding server later for search by meaning.

sh
docker build -t muninn-mcp https://github.com/vitoramaral10/muninn-mcp.git
docker run -d --name muninn -p 127.0.0.1:8000:8000 \
  -v "$PWD/notes:/notes" -v muninn-data:/data muninn-mcp
claude mcp add --transport http muninn http://127.0.0.1:8000/mcp

Twelve tools, one memory โ€‹

ToolDoes
mem_searchHybrid, text, semantic, title or permalink search
mem_readA note whole, by section, lines or token budget
mem_writeCreate or replace, guarded by checksum
mem_editAppend, find and replace, edit a section
mem_contextFollow relations through the graph
mem_move, mem_deleteA note or a whole folder
ToolDoes
mem_list, mem_findBrowse a folder or find files
mem_projectThe project and what changed recently
mem_schemaValidate and infer frontmatter schemas
mem_manThe manual, served by the server

Every parameter is in the tool reference.

Give your assistant a memory โ€‹

Muninn is free and open source under the MIT license.

Get started โ†’

Released under the MIT License.