Skip to main content
Glama
obsidianMCP

obsidianMCP

by creschendo

Obsidian MCP Server

An MCP server that gives Claude access to your Obsidian vault — read, search, and write notes directly from a conversation.

Prerequisites

Related MCP server: stellavault

Installation

git clone <repo-url>
cd obsidianMCP
npm install
npm run build

Claude Desktop configuration

Add the server to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Restart Claude Desktop after saving the file.

Available tools

Tool

Description

list_notes

List all .md files in the vault. Pass an optional directory to scope the listing to a subdirectory.

read_note

Return the full content of a note by its vault-relative path (e.g. folder/note.md).

search_notes

Case-insensitive full-text search. Returns the matching file path and a snippet (matched line ± 1 line of context) for each hit.

create_note

Create a new note. Fails if the file already exists. Intermediate directories are created automatically.

update_note

Overwrite an existing note with new content. Fails if the file does not exist.

Security note

Keep OBSIDIAN_VAULT_PATH in the env block of your Claude Desktop config — never hard-code it in the source or commit it to version control. Add a .env file to .gitignore if you use one locally for development.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables Claude to read, search, and analyze your entire knowledge vault locally via MCP tools like search, drafting, and linting.
      102 npm
      7
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables semantic search and reading of Obsidian Markdown notes through read-only MCP tools, allowing Claude to retrieve relevant passages from a local vault.
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Gives Claude and other MCP clients full control of a running Obsidian vault through the official Obsidian CLI, with fast filesystem reads for bulk operations and link-safe writes via the app.
      15 npm
      MIT