SoloMD — Claude Code MCP server: features and setup
Connects a Markdown notes folder to an AI agent for search, backlinks, tags, tasks and more. Write access is opt-in.
Open on GitHubWhat SoloMD does
SoloMD exposes a notes folder through MCP. An agent can list and read files, search text or regex patterns, inspect backlinks and tags, and retrieve headings or checkbox tasks. It can also query AutoGit history and compare note revisions.
The server starts in read-only mode. Creating notes, appending text and rolling back a file require --allow-write. Exporting notes to formats such as DOCX depends on Node.js and a SoloMD source checkout with dependencies installed in app/; otherwise, the export tool is not available.
Pass --workspace more than once to connect several vaults; the first one is the default. Cargo is needed for the Cargo installation method, and Node.js is required for export.
What it helps with
- search notes for a text fragment or regex
- find notes that link to a given file
- collect tags and open checkbox tasks
- compare a note with an earlier AutoGit revision
- create or append to a Markdown file with write access enabled
Example prompts for the agent
- Search my notes for matches to a regex that identifies API keys.
- Show backlinks to
project-plan.mdand list unfinished tasks. - Append this text to
meeting.md.
How to install SoloMD
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about SoloMD
How do I install SoloMD in Claude Code?
Install the server with cargo install --git https://github.com/zhitongblog/solomd solomd-mcp. Then configure the MCP client to run solomd-mcp with a vault path passed through --workspace.
What does SoloMD do?
It gives an MCP client tools to read and search a Markdown vault, inspect tags, links and tasks, and access AutoGit history. File changes require --allow-write.
Can SoloMD connect more than one notes folder?
Yes. Add a --workspace argument for each vault. The first is selected by default, and other workspaces can be addressed by alias.
