Markdown Vault MCP
MCP server to search, read, and write a folder of Markdown notes with hybrid search.
Tested on Linux
Use it
Linux x86_64
install markdown-vault-mcp via uv
uv tool install "markdown-vault-mcp"
Check that it works
markdown-vault-mcp --help 2>&1The output should contain “Usage: markdown-vault-mcp”.
Add it to your agent
claude mcp add markdown-vault-mcp -- markdown-vault-mcp serveJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"markdown-vault-mcp": {
"command": "markdown-vault-mcp",
"args": [
"serve"
]
}
}
}Set MARKDOWN_VAULT_MCP_SOURCE_DIR to your notes folder, then add markdown-vault-mcp serve as a server in your MCP client.
What it does
- Search, read and write Markdown notesTested
How to use it
- Start the server with
MARKDOWN_VAULT_MCP_SOURCE_DIR=<your notes folder> markdown-vault-mcp serve. - From your MCP client, call the
vault_readtool with the note'spath, such asnotes/<note>.md.
- Start the server with
- Search notes by keyword and meaningTested
How to use it
- Start the server with
MARKDOWN_VAULT_MCP_SOURCE_DIR=<your notes folder> markdown-vault-mcp serve. - Call the
vault_searchtool with aqueryandmodeset tokeyword.
- Start the server with
- Track backlinks, outlinks and broken linksTested
How to use it
- Start the server with
MARKDOWN_VAULT_MCP_SOURCE_DIR=<your notes folder> markdown-vault-mcp serve. - Call the
get_backlinkstool with the note'spathto see which notes link to it.
- Start the server with
- Commit, sync and review note history with GitTested
How to use it
- Make your notes folder a Git repository with at least one commit.
- Start the server with
MARKDOWN_VAULT_MCP_SOURCE_DIR=<your notes folder> markdown-vault-mcp serve. - Call the
get_historytool with the note'spathto review its history.
How far pickfit got
Linux x86_64
- Installs
- Connects
- 4 of 4 features work
- Works offline
Good for
- search a folder of Markdown notes
- read Markdown notes
- write back into Markdown notes
- follow backlinks and outlinks between notes
- sync notes with git history
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 5.1.0
An MCP client handshake over stdio listed 44 tools, and a call to vault_read returned a result.