SoloMD
Local MCP server that reads and searches a folder of Markdown notes for AI assistants
- 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.mcpbAdd 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"
]
}
}
}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"
]
}
}
}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

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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

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

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools