Skip to content
MCP server

SoloMD

Local MCP server that reads and searches a folder of Markdown notes for AI assistants

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Windows, Linux
Runs
Locally
Version
4.14.11
Listing updated
1 day ago

About SoloMD

SoloMD is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

This is a standalone Rust binary that points at one or more SoloMD vaults, which are ordinary folders of Markdown files. Each vault gets an alias, and the first becomes the default for tool calls. Per-vault AutoGit histories stay independent.

The 16 tools cover listing notes, reading one with its front matter, headings, tags and wikilinks, substring or regex search capped at 200 hits, backlinks, tag counts, outlines and task checkboxes. History tools show an AutoGit commit log and diffs, and others report sync status, build share URLs and read agent traces.

It is read-only by default. Writing, appending, rolling back a note and exporting require starting with --allow-write; until then those tools fail with a restart message. The editor itself is a free MIT-licensed Markdown app for macOS, Windows, Linux, iOS and Android.

Install

Run in a terminal

claude mcp add solomd -- npx -y https://github.com/zhitongblog/solomd/releases/download/v4.14.11/solomd-mcp-4.14.11.mcpb

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "solomd": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/zhitongblog/solomd/releases/download/v4.14.11/solomd-mcp-4.14.11.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "solomd": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/zhitongblog/solomd/releases/download/v4.14.11/solomd-mcp-4.14.11.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "solomd": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/zhitongblog/solomd/releases/download/v4.14.11/solomd-mcp-4.14.11.mcpb"
      ]
    }
  }
}

Tools this server provides (16)

Taken from the project documentation; the running server may differ.

list_notes
Walks the vault and returns note metadata.
read_note
Full content of one note with front matter, headings, tags and wikilinks.
search
Substring or regex search across the vault.
get_backlinks
Notes that wikilink a given note.
list_tags
Aggregated tag counts.
get_outline
Heading outline of one note.
list_tasks
Checkbox tasks across the vault.
autogit_log
Commit history of one note.
autogit_diff
Diff of a note between two commits.
sync_status
GitHub sync state.
share_url
Public share URL for a note.
read_agent_trace
Steps of one agent run.
write_note
Creates a note; needs --allow-write.
append_to_note
Appends text to a note; needs --allow-write.
autogit_rollback
Restores a note from a commit; needs --allow-write.
export_note
Exports a note to html, md, txt or docx; needs --allow-write.

What it does

Note listing and reading
Lists notes with metadata and reads one with front matter, headings, tags and wikilinks.
Search
Runs substring or regex search, capped at 200 hits with context.
Backlinks and tags
Finds notes linking to a note and counts tags across the vault.
Tasks and outlines
Lists checkbox tasks and heading outlines.
AutoGit history
Shows commit logs and diffs for a note.
Multiple vaults
Registers several workspaces with aliases.
Opt-in writing
Write, append, rollback and export tools need --allow-write.

Good for

  • Ask an assistant to find every open task in a notes vault
  • Trace which notes link to a given note
  • Review how a note changed over time
  • Have an agent append meeting notes to a Markdown folder when allowed

Pricing

Open source

Free, MIT-licensed

Prices change. Check solomd.app before you buy.

SoloMD FAQ

Is it read-only?

By default yes; write_note, append_to_note, autogit_rollback and export_note need --allow-write.

How many tools are there?

16 tools.

Which clients can use it?

Claude Code, Codex CLI, Cursor, Continue and any MCP client.

How does it run?

The client starts the solomd-mcp binary over stdio with one or more --workspace paths.

Is SoloMD free?

Yes. SoloMD is open source, so you can use and self-host it for free.

How do I add SoloMD to Claude Code?

Run this command in your terminal: claude mcp add solomd -- npx -y https://github.com/zhitongblog/solomd/releases/download/v4.14.11/solomd-mcp-4.14.11.mcpb

What are the best alternatives to SoloMD?

The closest alternatives to SoloMD are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

Alternatives to SoloMD

  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. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. 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
  5. 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
  6. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools