Your notes stay yours
Each note is a Markdown file with YAML frontmatter, readable in any editor and versionable with git. The index beside them is derived; delete it and it is rebuilt.
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.
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.
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.---
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]]One container, one folder of notes. Add an embedding server later for search by meaning.
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| Tool | Does |
|---|---|
mem_search | Hybrid, text, semantic, title or permalink search |
mem_read | A note whole, by section, lines or token budget |
mem_write | Create or replace, guarded by checksum |
mem_edit | Append, find and replace, edit a section |
mem_context | Follow relations through the graph |
mem_move, mem_delete | A note or a whole folder |
| Tool | Does |
|---|---|
mem_list, mem_find | Browse a folder or find files |
mem_project | The project and what changed recently |
mem_schema | Validate and infer frontmatter schemas |
mem_man | The manual, served by the server |
Every parameter is in the tool reference.
Muninn is free and open source under the MIT license.