Solomd
A markdown editor — and the bridge to your LLM. Local-first, MIT, ~15 MB. Bundled MCP server lets Claude Code / Codex / Cursor drive your vault directly. 14 AI providers BYOK.
What is Solomd?
Solomd is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to markdown editor — and the bridge to your llm. local-first, mit, ~15 mb. bundled mcp server lets claude code / codex / cursor drive your vault directly. 14 ai providers byok.
A markdown editor — and the bridge to your LLM. Local-first, MIT, ~15 MB. Bundled MCP server lets Claude Code / Codex / Cursor drive your vault directly. 14 AI providers BYOK.
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A markdown editor — and the bridge to your LLM. Local-first,
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx solomdConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Solomd
SoloMD is a local-first markdown editor (~15 MB) with a bundled MCP server that lets AI coding agents such as Claude Code, Codex, and Cursor drive your markdown vault directly. It exposes 13 MCP tools — including 5 exclusive tools for AutoGit version control, sync status, and public share URLs — enabling agents to read, write, commit, and roll back notes programmatically. With support for 14 BYOK AI providers (OpenAI, Claude, Gemini, DeepSeek, Groq, and more) and credentials stored in the OS keychain, SoloMD gives developers a private, scriptable knowledge base that agents can treat as a first-class workspace.
Prerequisites
- SoloMD desktop application installed on macOS, Windows, or Linux
- At least one AI provider API key (OpenAI, Anthropic Claude, Gemini, DeepSeek, Groq, or others) for BYOK configuration
- An MCP-compatible AI client such as Claude Desktop, Claude Code, Cursor, or Codex
- Node.js available if using the CLI invocation method
Install SoloMD on your operating system
Install SoloMD using the package manager for your OS. On macOS use Homebrew, on Windows use winget or the PowerShell installer, and on Linux download the appropriate package from the releases page.
# macOS
brew install --cask zhitongblog/solomd/solomd
# Windows
winget install solomd
# Linux (AUR)
yay -S solomd-binOpen SoloMD and configure an AI provider
Launch SoloMD, go to Settings, and add your API key for at least one AI provider. Keys are stored in the OS keychain (macOS Keychain, Windows Credential Manager, or Linux libsecret) and never in config files.
Generate the MCP configuration snippet
Use the built-in CLI command to output the exact MCP configuration block for your vault path. Copy this output into your AI client's MCP config file.
solomd mcp-configAdd the MCP server to your AI client configuration
Open your AI client's config file and paste the configuration generated in the previous step. Adjust the workspace path if needed. For multiple vaults, add additional --workspace arguments.
{
"mcpServers": {
"solomd": {
"command": "/Applications/SoloMD.app/Contents/Resources/solomd-mcp",
"args": ["--workspace", "/Users/me/Documents/SoloMD"]
}
}
}Restart your AI client and test the connection
Fully restart your AI client so it picks up the new MCP server configuration. Verify the solomd tools appear and test by asking the agent to list or create a note in your vault.
Solomd Examples
Client configuration
Claude Desktop configuration for SoloMD with a single vault. The solomd-mcp binary path varies by OS — use 'solomd mcp-config' to get the exact path for your installation.
{
"mcpServers": {
"solomd": {
"command": "/Applications/SoloMD.app/Contents/Resources/solomd-mcp",
"args": ["--workspace", "/Users/me/Documents/SoloMD"]
}
}
}Prompts to try
After connecting, use these prompts to drive your SoloMD vault from Claude Code or another MCP-compatible agent.
- "List all notes in my vault that were modified this week"
- "Create a new note called 'Project Ideas' with a summary of our conversation"
- "Rewrite this week's daily notes into a consolidated weekly review and commit it"
- "Show me the AutoGit log for my vault — what changed recently?"
- "Roll back the last change to my 'Architecture Decisions' note"Troubleshooting Solomd
The solomd-mcp binary path in the config is wrong or the server fails to start
Run 'solomd mcp-config' in your terminal to get the correct binary path for your installation. The path differs between macOS, Windows, and Linux. Paste the exact output into your MCP client config.
Vault changes made by the agent are not showing up in SoloMD
Check that the --workspace path in the MCP config matches the folder SoloMD has open as a workspace. The paths must point to the same directory. Restart SoloMD after the agent writes files.
Frequently Asked Questions about Solomd
What is Solomd?
Solomd is a Model Context Protocol (MCP) server that markdown editor — and the bridge to your llm. local-first, mit, ~15 mb. bundled mcp server lets claude code / codex / cursor drive your vault directly. 14 ai providers byok. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Solomd?
Follow the installation instructions on the Solomd GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Solomd?
Solomd works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Solomd free to use?
Yes, Solomd is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Solomd Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to Solomd? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.
MemPalace
★ 52.6kA local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically
Kratos
★ 25.7k🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.
Context Mode
★ 15.4kAn MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm
Memu
★ 13.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u
Everos
★ 5.4kBuild, evaluate, and integrate long-term memory for self-evolving agents.
Browse More Knowledge & Memory MCP Servers
Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Solomd in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Solomd?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.