Obsidian MCP Local
Obsidian MCP Local
MCP local en Node.js + TypeScript para exponer tu vault de Obsidian a VS Code + GitHub Copilot.
Ha sido diseñado para uso local mediante stdio, con enfoque en leer y escribir notas Markdown dentro de tu vault.
Install
npm install -g obsidian-mcp-local
Related MCP server: Obsidian MCP Server
Features
Herramientas disponibles
search_notes(query)busca por texto en la ruta, frontmatter y contenido de las notas
devuelve resultados clasificados con un pequeño extracto
get_note(path)abre una nota del vault
devuelve
path,frontmatterycontent
create_note(path, content, overwrite?)crea una nota nueva
opcionalmente sobrescribe una nota existente
append_to_note(path, content)añade contenido al final de una nota existente
find_by_tag(tag)encuentra notas por etiqueta
admite
tagsen el frontmatter y etiquetas inline en el contenido
Reglas implementadas
solo accede a archivos dentro del vault configurado
ignora directorios como:
.obsidian.gitnode_modules
trabaja solo con archivos
.mdnormaliza rutas para evitar el acceso fuera del directorio base
Estructura del proyecto
obsidian-mcp-local/
package.json
tsconfig.json
README.md
.vscode/
mcp.example.json
src/
index.tsRequisitos previos
Node.js 20+
npm
VS Code con GitHub Copilot
un vault de Obsidian local
Instalación
En el directorio del proyecto:
npm install
npm run buildPara desarrollo:
npm run devPara ejecutar la versión compilada:
npm startCómo usar en VS Code
1. Compila el proyecto
npm install
npm run build2. Ajusta el archivo MCP de VS Code
Copia el contenido de .vscode/mcp.example.json a tu .vscode/mcp.json en el espacio de trabajo donde vayas a usar Copilot.
Ejemplo: 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 vía npx (sin necesidad de build local):
{
"servers": {
"obsidian-local-vault": {
"command": "npx",
"args": ["-y", "obsidian-mcp-local"],
"env": {
"OBSIDIAN_VAULT_PATH": "D:/Obsidian/Vault"
}
}
}
}3. Actualiza las rutas
Sustituye:
C:/caminho/para/obsidian-mcp-local/dist/index.jsD:/Obsidian/Vault
por las rutas reales de tu máquina.
4. Reinicia/recarga VS Code
Después de esto, Copilot debería descubrir el servidor MCP.
Ejemplos de uso en Copilot Chat
“Busca en mi vault notas sobre .NET”
“Abre la nota
knowledge/backend/dotnet.md”“Crea una nota en
inbox/ideias-mcp.mdcon un resumen de lo que discutimos”“Añade al final de la nota
daily/2026-04-06.mdel texto- testar MCP local”“Encuentra notas con la etiqueta
#arquitetura”
Posibles mejoras futuras
append_under_headinganálisis de
[[wikilinks]]get_backlinks(note)índice en SQLite para búsqueda rápida
lista blanca de carpetas para escritura (
inbox/,daily/,scratch/)bloqueo configurable de escritura en determinadas carpetas
Observaciones importantes
Este proyecto no depende de que Obsidian esté abierto.
Opera directamente sobre los archivos del vault.
Si habilitas la escritura tanto en Obsidian como en VS Code, el control de concurrencia queda bajo tu responsabilidad.
El proyecto actualmente asume que el vault es una carpeta Markdown local.
Archivo principal
La implementación está en:
src/index.ts
Licencia
Uso personal / base inicial para personalización.
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