Skip to main content
Glama
Obsidian MCP Local

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, frontmatter y content

  • 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 tags en el frontmatter y etiquetas inline en el contenido

Reglas implementadas

  • solo accede a archivos dentro del vault configurado

  • ignora directorios como:

    • .obsidian

    • .git

    • node_modules

  • trabaja solo con archivos .md

  • normaliza 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.ts

Requisitos 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 build

Para desarrollo:

npm run dev

Para ejecutar la versión compilada:

npm start

Cómo usar en VS Code

1. Compila el proyecto

npm install
npm run build

2. 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.js

  • D:/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.md con un resumen de lo que discutimos”

  • “Añade al final de la nota daily/2026-04-06.md el texto - testar MCP local”

  • “Encuentra notas con la etiqueta #arquitetura”

Posibles mejoras futuras

  • append_under_heading

  • aná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 tools
append_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

    C2.1/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool name clearly indicates a distinct operation: create, get, append, search, and find by tag. No significant overlap is apparent.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., create_note, search_notes), making the set predictable.

    Tool Count5/5

    Five tools cover essential note operations (create, retrieve, modify, search, tag) without unnecessary bloat or deficiency for the domain.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      6
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables 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
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      27
      1
      MIT