Obsidian MCP

seynurmammad0v/obsidian-mcp

Exposes 12 tools that treat your Obsidian vault as a queryable graph, no Obsidian app or database required. Read and search notes with tag and frontmatter filtering, traverse the wikilink graph with BFS/DFS, find shortest paths between notes, and detect connected components or bridge nodes. Write operations include creating notes, patching sections, and moving files with automatic backlink updates across the entire vault. Scans your vault once on startup to build an in-memory graph, then watches for changes incrementally. Reach for this when you want Claude to navigate and manipulate your existing Obsidian knowledge base as a first-class graph structure rather than flat markdown files.

GitHub stars: 1
tools: 13
transport: STDIO
last updated: Mar 17, 2026

View on GitHub

Tools

13 tools

Public tool metadata for what this MCP can expose to an agent.

obsidian_list_files_in_dir1 params

Parameters* required

dirpathstring

obsidian_list_files_in_vault

No parameter schema in public metadata yet.

obsidian_get_file_contents1 params

Parameters* required

filepathstring

obsidian_simple_search2 params

Parameters* required

context_lengthstring

querystring

obsidian_patch_content5 params

Parameters* required

contentstring

filepathstring

operationstring

targetstring

target_typestring

obsidian_append_content2 params

Parameters* required

contentstring

filepathstring

obsidian_put_content2 params

Parameters* required

contentstring

filepathstring

obsidian_delete_file2 params

Parameters* required

confirmstring

filepathstring

obsidian_complex_search1 params

Parameters* required

querystring

obsidian_batch_get_file_contents1 params

Parameters* required

filepathsstring

obsidian_get_periodic_note2 params

Parameters* required

periodstring

typestring

obsidian_get_recent_periodic_notes3 params

Parameters* required

include_contentstring

limitstring

periodstring

obsidian_get_recent_changes2 params

Parameters* required

daysstring

limitstring

Readme

obsidian-mcp

MCP server that turns any Obsidian vault into an AI-queryable knowledge graph.

What makes this different from the 24+ existing Obsidian MCP servers:

Graph-first — BFS, shortest path, connected components, bridge detection via [[wikilinks]]
Zero infrastructure — No database, no Obsidian running, no API keys
Vault-agnostic — Works with any existing vault, no required structure
Backlink-aware writes — move_note auto-updates all references across the vault
Tiny — 4 runtime dependencies, ~42KB bundle

Quick Start

npx obsidian-mcp --vault ~/my-obsidian-vault

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp", "--vault", "/path/to/vault"]
    }
  }
}

Claude Code

claude mcp add obsidian -- npx -y obsidian-mcp --vault /path/to/vault

Tools (12)

Reading & Discovery

View the full README on GitHub

Details

Repository: github.com/seynurmammad0v/obsidian-mcp
Category: Documents & Knowledge
Package: @smammadov/obsidian-mcp
Transport: STDIO
Registry: MCP registry, active

Obsidian MCP

Tools

Readme

obsidian-mcp

Quick Start

Claude Desktop

Claude Code

Tools (12)

Reading & Discovery

Details

Related Documents & Knowledge MCP servers