Obsidian MCP

Turns Obsidian vaults into AI-queryable knowledge graphs with 12 tools

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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

Terminal

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

Claude Desktop

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

config.json

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

Claude Code

Terminal

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

Tools (12)

Reading & Discovery

Tool	Description
`vault_stats`	Overview: total notes, tags, links, orphans, components, top tags/hubs
`read_note`	Full content + frontmatter + links + backlinks + sections
`search_notes`	Filter by tags, folder, frontmatter, keyword. All combinable

Graph Traversal

Tool	Description
`graph_neighbors`	Direct links + backlinks for a note
`graph_traverse`	BFS/DFS from a note, N hops deep with tag filtering
`graph_shortest_path`	Shortest link chain between two notes
`graph_analyze`	Components, orphans, bridges, hubs, dead links

Writing & Manipulation

Tool	Description
`create_note`	Create with content + frontmatter
`patch_note`	Append, prepend, or replace a section. Update frontmatter
`move_note`	Rename/move + auto-update all backlinks across vault
`delete_note`	Delete + report broken links
`manage_tags`	Add/remove/rename tags (vault-wide rename supported)

Configuration

Zero-config by default. Optional .obsidian-mcp.json in vault root:

config.json

{
  "ignore": ["templates/", "daily-notes/", ".trash/"],
  "watchDebounce": 100,
  "maxTraversalDepth": 10,
  "maxSearchResults": 500
}

CLI Flags

Code

--vault <path>       Path to Obsidian vault (required)
--verbose            Enable debug logging
--log-level <level>  error | warn | info | debug (default: info)

How It Works

On startup, scans all .md files and builds an in-memory graph (~1-3s for 1k notes)
File watcher detects changes and updates the graph incrementally (~5ms per change)
Claude queries the graph via MCP tools — no re-scanning needed
Write operations update both the filesystem and the graph atomically

Hardcoded exclusions: .obsidian/, .trash/, node_modules/

Development

Terminal

npm install
npm test              # Run 66 tests
npm run build         # Build to dist/
npm run dev -- --vault test/fixtures/vault  # Dev mode

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Knowledge & Memory View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Obsidian MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "obsidian-mcp": { "command": "npx", "args": ["-y", "Obsidian MCP"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/obsidian-mcp?style=directory)](https://allmcps.com/mcp/obsidian-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/obsidian-mcp"><img src="https://allmcps.com/api/badge/obsidian-mcp?style=directory" alt="Obsidian MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryKnowledge & Memory

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🧠 Knowledge & Memory →Best MCP servers for Memory & Knowledge →Alternatives to Obsidian MCP →Install in Claude Desktop Install in Cursor Install in VS Code

Obsidian MCP

Turns Obsidian vaults into AI-queryable knowledge graphs with 12 tools

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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

Terminal

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

Claude Desktop

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

config.json

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

Claude Code

Terminal

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

Tools (12)

Reading & Discovery

Tool	Description
`vault_stats`	Overview: total notes, tags, links, orphans, components, top tags/hubs
`read_note`	Full content + frontmatter + links + backlinks + sections
`search_notes`	Filter by tags, folder, frontmatter, keyword. All combinable

Graph Traversal

Tool	Description
`graph_neighbors`	Direct links + backlinks for a note
`graph_traverse`	BFS/DFS from a note, N hops deep with tag filtering
`graph_shortest_path`	Shortest link chain between two notes
`graph_analyze`	Components, orphans, bridges, hubs, dead links

Writing & Manipulation

Tool	Description
`create_note`	Create with content + frontmatter
`patch_note`	Append, prepend, or replace a section. Update frontmatter
`move_note`	Rename/move + auto-update all backlinks across vault
`delete_note`	Delete + report broken links
`manage_tags`	Add/remove/rename tags (vault-wide rename supported)

Configuration

Zero-config by default. Optional .obsidian-mcp.json in vault root:

config.json

{
  "ignore": ["templates/", "daily-notes/", ".trash/"],
  "watchDebounce": 100,
  "maxTraversalDepth": 10,
  "maxSearchResults": 500
}

CLI Flags

Code

--vault <path>       Path to Obsidian vault (required)
--verbose            Enable debug logging
--log-level <level>  error | warn | info | debug (default: info)

How It Works

On startup, scans all .md files and builds an in-memory graph (~1-3s for 1k notes)
File watcher detects changes and updates the graph incrementally (~5ms per change)
Claude queries the graph via MCP tools — no re-scanning needed
Write operations update both the filesystem and the graph atomically

Hardcoded exclusions: .obsidian/, .trash/, node_modules/

Development

Terminal

npm install
npm test              # Run 66 tests
npm run build         # Build to dist/
npm run dev -- --vault test/fixtures/vault  # Dev mode

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Knowledge & Memory View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Obsidian MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "obsidian-mcp": { "command": "npx", "args": ["-y", "Obsidian MCP"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/obsidian-mcp?style=directory)](https://allmcps.com/mcp/obsidian-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/obsidian-mcp"><img src="https://allmcps.com/api/badge/obsidian-mcp?style=directory" alt="Obsidian MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryKnowledge & Memory

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🧠 Knowledge & Memory →Best MCP servers for Memory & Knowledge →Alternatives to Obsidian MCP →Install in Claude Desktop Install in Cursor Install in VS Code