obsidian-mcp MCP Server

An MCP (Model Context Protocol) Server that gives AI assistants direct access to your Obsidian vault. Read, write, search, and navigate notes using natural language — with any MCP-compatible client.

Local serverstdio

What is the obsidian-mcp Server?

obsidian-mcp is an MCP project maintained in the lwaetzig/obsidian-mcp repository. The maintainer describes its purpose as “An MCP (Model Context Protocol) Server that gives AI assistants direct access to your Obsidian vault. Read, write, search, and navigate notes using natural language…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using node. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares OBSIDIAN_VAULT_PATH. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
obsidian_list_notesList notes in the vault, optionally filtered to a folder. Paginated.
obsidian_read_noteRead the full content of a note by vault-relative path.
obsidian_create_noteCreate a new note with optional YAML frontmatter.
obsidian_update_noteOverwrite an existing note's content and frontmatter.
obsidian_append_to_noteAppend content to a note (creates it if missing).
obsidian_delete_notePermanently delete a note.
obsidian_move_noteMove or rename a note to a new path.
obsidian_get_note_metadataRead only the frontmatter and tags, without loading the body.
obsidian_search_notesFull-text search across all notes (case-insensitive).
obsidian_search_by_tagFind all notes with a specific tag.
obsidian_get_backlinksFind all notes that [[link]] to a given note.
obsidian_list_foldersList folders in the vault with note counts.
obsidian_create_folderCreate a new folder (parents created automatically).

How to install the obsidian-mcp Server

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": [
        "/absolute/path/to/obsidian-mcp/dist/index.js"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
OBSIDIAN_VAULT_PATHDeclared in the maintainer’s client configuration.Check documentation