Samong
Local MCP server that lets agents search and write Markdown notes in your repos
- Pricing
- Open source
- Platforms
- macOS, Windows, Linux
- Runs
- Locally
- Version
- 0.7.0
- Listing updated
- 3 days ago
About Samong
Samong is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Samong indexes the .md files already sitting in your repositories rather than a separate notes folder. It respects .gitignore, skips dependency directories such as node_modules, and keeps a disposable index in a .brain folder that can be rebuilt from the files at any time. A samong doctor command reports what counted as a note and what was skipped.
The MCP binary, samong-mcp, runs on your machine over stdio and is packaged as an .mcpb bundle. It gives agents six tools to list, read, search, save and follow links, with no delete tool. Overwriting an existing note requires the hash returned by read_note, so an agent that never opened a note cannot silently replace it. Search returns few hits by default to keep context small.
Search is full-text with dictionary word segmentation, which matters for Thai, Japanese or Chinese notes that have no spaces between words. Results are also nudged by how connected a note is, with the boost capped at 25 percent. Optional local semantic search needs a build with the semantic feature. The project is Apache-2.0 and the site states there is no account and no cloud.
Install
Run in a terminal
claude mcp add samong -- npx -y https://github.com/waanvar/samong/releases/download/v0.7.0/samong-mcp.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"samong": {
"command": "npx",
"args": [
"-y",
"https://github.com/waanvar/samong/releases/download/v0.7.0/samong-mcp.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"samong": {
"command": "npx",
"args": [
"-y",
"https://github.com/waanvar/samong/releases/download/v0.7.0/samong-mcp.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"samong": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/waanvar/samong/releases/download/v0.7.0/samong-mcp.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"samong": {
"command": "npx",
"args": [
"-y",
"https://github.com/waanvar/samong/releases/download/v0.7.0/samong-mcp.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"samong": {
"command": "npx",
"args": [
"-y",
"https://github.com/waanvar/samong/releases/download/v0.7.0/samong-mcp.mcpb"
]
}
}
}Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- read_note
- Return a note along with a hash that must be passed back to overwrite it.
What it does
- Repo-native notes
- Treats the .md files you would commit as the knowledge base.
- Safe overwrites
- Saving over an existing note needs the hash from read_note, so unread notes are never replaced.
- No delete tool
- Agents can list, read, search, save and follow links but cannot erase notes.
- Word segmentation
- Full-text search handles languages written without spaces.
- Link graph
- Wikilinks and backlinks resolve across every registered vault.
- Search evaluation
- samong eval scores search against real questions with hit@k and MRR.
Good for
- Let an agent search past design decisions before it starts a task
- Have an agent record what it worked out so the next session starts informed
- Search Thai, Japanese or Chinese Markdown notes
- Share one local note set across several MCP-capable assistants
Pricing
Open source
Apache-2.0; no account or paid plan mentioned
Prices change. Check samong.dev before you buy.
Samong FAQ
Does it need an account or the cloud?
No. The site says it is one binary, works offline and your notes never leave the machine.
Can an agent delete my notes?
No. The six tools have no delete, and overwriting needs the hash returned by read_note.
Which assistants can use it?
Any MCP client that runs local stdio servers. The site shows one-line setup for Claude Code, Codex CLI, Gemini CLI, Qwen Code, Kimi Code CLI and Grok Build.
What licence is it under?
Apache-2.0; the name and logo are not covered.
Is Samong free?
Yes. Samong is open source, so you can use and self-host it for free.
How do I add Samong to Claude Code?
Run this command in your terminal: claude mcp add samong -- npx -y https://github.com/waanvar/samong/releases/download/v0.7.0/samong-mcp.mcpb
What are the best alternatives to Samong?
The closest alternatives to Samong are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.
Alternatives to Samong

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
Not checked yet- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity
MedXpert 图书馆连接器(通用版)
MCP serverLocal MCP server that searches and answers questions over your own Markdown wiki
Runs locally- 4 tools
- Open source
- Knowledge and memory