# Samong

> Samong is an open-source MCP server for knowledge and memory. Local MCP server that lets agents search and write Markdown notes in your repos. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI
- **Website:** https://samong.dev
- **Repository:** https://github.com/waanvar/samong
- **MCP Registry name:** io.github.waanvar/samong
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add samong -- npx -y https://github.com/waanvar/samong/releases/download/v0.7.0/samong-mcp.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "samong": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/waanvar/samong/releases/download/v0.7.0/samong-mcp.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "samong": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/waanvar/samong/releases/download/v0.7.0/samong-mcp.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "samong": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/waanvar/samong/releases/download/v0.7.0/samong-mcp.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "samong": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/waanvar/samong/releases/download/v0.7.0/samong-mcp.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "samong": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/waanvar/samong/releases/download/v0.7.0/samong-mcp.mcpb"
      ]
    }
  }
}
```

## Tools

- `read_note`: Return a note along with a hash that must be passed back to overwrite it.

## 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

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/samong
