Provides tools for reading, searching, and writing notes in an Obsidian vault (or any folder of Markdown files).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@vault-mcp-server search my vault for notes about project alpha"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server genérico pra consultar e alimentar um vault Obsidian (ou qualquer
pasta de arquivos .md). Não sabe nada sobre a estrutura de nenhum vault
específico — isso é responsabilidade do AGENTS.md/convenções de cada vault,
lido pelo agente que usa as tools, não codificado aqui.
Módulo | Ferramenta | Descrição |
Busca |
| Busca texto (regex, cai pra literal se inválido) em |
Busca |
| Busca notas com a tag no frontmatter ( |
Busca |
| Notas que linkam pra essa via |
Leitura |
| Conteúdo bruto de uma nota (frontmatter incluso) |
Leitura |
| Lista recursiva de |
Leitura |
| Subpastas de um nível |
Leitura |
| Só o frontmatter parseado |
Escrita |
| Cria ( |
Escrita |
| Renomeia, mesma pasta |
Escrita |
| Move/renomeia pra qualquer caminho no vault |
Escrita |
| Soft delete — move pra |
Limitação conhecida: rename_note/move_note não reescrevem
[[wikilinks]] que outras notas tenham pra elas (diferente do Obsidian, que
faz isso automaticamente pela UI). Rode get_backlinks antes de renomear pra
saber o que pode quebrar.
write_note não faz git. Só grava o arquivo — commit/push continua
manual (mesmo fluxo que o AGENTS.md de cada vault já deve documentar pra
agentes com acesso a shell).
Related MCP server: Obsidian CLI MCP Server
Variável | Default | Faz |
|
| Raiz do vault a servir — trocar aponta pra qualquer outro vault |
|
| Limite de resultados de busca (1-500) |
|
| Tamanho do trecho retornado por match (20-1000) |
|
| Limite de tamanho de conteúdo em |
| (vazio) | CSV de pastas de topo extras a bloquear pra leitura/escrita, além de |
Todo caminho é resolvido e validado contra escapar da raiz do vault (sem
.., sem caminho absoluto fora do vault). Só arquivos .md são
lidos/escritos. Pastas de topo em VAULT_MCP_BLOCKED_FOLDERS (+ as três
padrão) ficam fora tanto de leitura quanto de escrita.
Pra este vault específico (~/vault), bloqueando também _scripts/ (é
tooling, não notas):
claude mcp add --scope user vault \
--env VAULT_MCP_ROOT=$HOME/vault \
--env VAULT_MCP_BLOCKED_FOLDERS=_scripts \
-- uv run --directory ~/dev/pessoal/vault-mcp-server server.py--scope user deixa disponível em qualquer sessão do Claude Code, em
qualquer repo — não só quando se está dentro do vault. O mesmo binário serve
qualquer outro vault só trocando VAULT_MCP_ROOT.
Codex CLI ainda não está instalado nesta máquina; quando estiver, o mesmo
servidor se registra via entrada mcp_servers no config.toml do Codex,
apontando pro mesmo comando (uv run --directory ... server.py) com as
mesmas env vars.
Inputs: path (required). Returns: result
Inputs: path (required). Returns: result
Inputs: path (required). Returns: result
Inputs: subfolder. Returns: result
Inputs: subfolder. Returns: result
Inputs: path (required), new_path (required). Returns: result
Inputs: path (required). Returns: result
Inputs: path (required), new_filename (required). Returns: result
Inputs: tag (required), subfolder. Returns: result
Inputs: query (required), subfolder, max_results. Returns: result
Inputs: path (required), content (required), mode. Returns: result
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 11 tools
Most tools target distinct operations: search, read, write, rename, move, delete, metadata. The only potential overlap is between search_notes and search_by_tag, but they are differentiated by search mechanism (content vs tag).
All tool names follow a consistent verb_noun pattern in lowercase snake_case (e.g., search_notes, read_note, list_folders, delete_note). This is highly predictable and uniform.
With 11 tools, the server is well-scoped for note management. It covers essential operations without redundancy or unnecessary bloat.
The toolset provides comprehensive note lifecycle coverage (create, read, update, delete), plus search, backlinks, metadata, and folder listing. Minor omissions like an explicit tag listing or folder contents are acceptable workarounds.
Hosted MCP server for Obsidian Sync vaults: read, search, edit notes. Not affiliated with Obsidian.
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Serve a folder of Markdown notes as an MCP server: hybrid search, reading, and sourced answers.
MCP-native open-source Notion alternative: read & write pages, databases and kanban boards.
