Skip to content
MCP server

Samong

Local MCP server that lets agents search and write Markdown notes in your repos

Runs locallyStatus and history
Install
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.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "samong": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/waanvar/samong/releases/download/v0.7.0/samong-mcp.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "samong": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/waanvar/samong/releases/download/v0.7.0/samong-mcp.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP 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
  4. Local-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
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity