Obsidian MCP Local
Obsidian MCP Local
MCP local em Node.js + TypeScript para expor seu vault do Obsidian ao VS Code + GitHub Copilot.
Ele foi pensado para uso local via stdio, com foco em ler e escrever notas Markdown dentro do seu vault.
Install
npm install -g obsidian-mcp-local
Related MCP server: Obsidian MCP Server
Features
Tools disponíveis
search_notes(query)busca por texto no path, frontmatter e conteúdo das notas
retorna resultados ranqueados com pequeno excerpt
get_note(path)abre uma nota do vault
retorna
path,frontmatterecontent
create_note(path, content, overwrite?)cria uma nota nova
opcionalmente sobrescreve uma nota existente
append_to_note(path, content)adiciona conteúdo no final de uma nota existente
find_by_tag(tag)encontra notas por tag
suporta
tagsno frontmatter e tags inline no conteúdo
Regras implementadas
só acessa arquivos dentro do vault configurado
ignora diretórios como:
.obsidian.gitnode_modules
trabalha apenas com arquivos
.mdnormaliza paths para evitar acesso fora do diretório base
Estrutura do projeto
obsidian-mcp-local/
package.json
tsconfig.json
README.md
.vscode/
mcp.example.json
src/
index.tsPré-requisitos
Node.js 20+
npm
VS Code com GitHub Copilot
um vault do Obsidian local
Instalação
No diretório do projeto:
npm install
npm run buildPara desenvolvimento:
npm run devPara rodar a versão compilada:
npm startComo usar no VS Code
1. Compile o projeto
npm install
npm run build2. Ajuste o arquivo MCP do VS Code
Copie o conteúdo de .vscode/mcp.example.json para o seu .vscode/mcp.json no workspace onde você vai usar o Copilot.
Exemplo: utilizando localmente:
{
"servers": {
"obsidian-local-vault": {
"type": "stdio",
"command": "node",
"args": ["C:/caminho/para/obsidian-mcp-local/dist/index.js"],
"env": {
"OBSIDIAN_VAULT_PATH": "D:/Obsidian/Vault"
}
}
}
}utilizando via npx (sem necessidade de build local):
{
"servers": {
"obsidian-local-vault": {
"command": "npx",
"args": ["-y", "obsidian-mcp-local"],
"env": {
"OBSIDIAN_VAULT_PATH": "D:/Obsidian/Vault"
}
}
}
}3. Atualize os caminhos
Substitua:
C:/caminho/para/obsidian-mcp-local/dist/index.jsD:/Obsidian/Vault
pelos caminhos reais da sua máquina.
4. Reinicie/recarrregue o VS Code
Depois disso, o Copilot deve descobrir o servidor MCP.
Exemplos de uso no Copilot Chat
“Procure no meu vault notas sobre .NET”
“Abra a nota
knowledge/backend/dotnet.md”“Crie uma nota em
inbox/ideias-mcp.mdcom um resumo do que discutimos”“Adicione no final da nota
daily/2026-04-06.mdo texto- testar MCP local”“Encontre notas com a tag
#arquitetura”
Possíveis melhorias futuras
append_under_headingparsing de
[[wikilinks]]get_backlinks(note)índice em SQLite para busca rápida
whitelist de pastas para escrita (
inbox/,daily/,scratch/)bloqueio configurável de escrita em determinadas pastas
Observações importantes
Este projeto não depende do Obsidian aberto.
Ele opera diretamente sobre os arquivos do vault.
Se você habilitar escrita tanto no Obsidian quanto no VS Code, o controle de concorrência fica por sua conta.
O projeto hoje assume que o vault é uma pasta Markdown local.
Arquivo principal
A implementação está em:
src/index.ts
Licença
Uso pessoal / base inicial para customização.
Available Tools
5 toolsappend_to_noteD
Inputs: path (required), content (required).
create_noteD
Inputs: path (required), content (required), overwrite.
find_by_tagD
Inputs: tag (required).
get_noteD
Inputs: path (required).
search_notesD
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool name clearly indicates a distinct operation: create, get, append, search, and find by tag. No significant overlap is apparent.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., create_note, search_notes), making the set predictable.
Five tools cover essential note operations (create, retrieve, modify, search, tag) without unnecessary bloat or deficiency for the domain.
The set includes create, read, update (via append), and search operations but lacks a delete operation, which is a notable gap for a complete CRUD surface.
Maintenance
Related MCP Connectors
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…
Search your Obsidian vault to quickly find notes by title or keyword, summarize related content, a…
Search, read, and safely update Markdown notes in your connected Phasoric knowledge vaults.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables direct file system access to Obsidian vaults with auto-discovery, full-text search, and note operations. Supports reading, writing, and searching across Obsidian notes without requiring plugins or REST API.6MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Obsidian vaults through direct filesystem access, supporting note management, lightning-fast search with SQLite indexing, image analysis, tag/link management, and bulk operations.MIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to read, write, search, and navigate Obsidian vault notes with support for CRUD operations, full-text search, graph navigation, daily notes, and frontmatter management.3,713 npm-
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with local Obsidian vaults through direct filesystem access for reading, creating, and managing notes. It features high-performance SQLite indexing for fast searches, regex support, and tools for organizing tags and links without requiring additional plugins.271MIT