mcpField
O
Obsidian MCP

Obsidian MCP

Local
github.com/seynurmammad0vMemory & Knowledge1Updated 32w ago
Repository

About Obsidian MCP

Obsidian MCP is an MCP server that lets AI clients query and edit an Obsidian vault as a linked knowledge graph. It builds the graph from wikilinks without requiring a database, a running Obsidian app, or a prescribed vault layout.

Key features

  1. 01Search notes by content and metadata
  2. 02Traverse links and find shortest paths
  3. 03Analyze hubs, orphans, bridges, and components
  4. 04Create, edit, move, and delete notes
  5. 05Maintain backlinks and manage tags

Use cases

  1. 01Find notes matching tags or keywords
  2. 02Trace connections between two notes
  3. 03Identify orphaned notes and broken links
  4. 04Update vault notes while preserving backlinks

MCP support

The server exposes 12 tools for reading, searching, graph analysis, and vault editing to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "seynurmammad0v-obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "@smammadov/obsidian-mcp"
      ]
    }
  }
}
Run commandnpx -y @smammadov/obsidian-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smammadov/obsidian-mcp1.0.3

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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
ToolDescription
vault_statsOverview: total notes, tags, links, orphans, components, top tags/hubs
read_noteFull content + frontmatter + links + backlinks + sections
search_notesFilter by tags, folder, frontmatter, keyword. All combinable
Graph Traversal
ToolDescription
graph_neighborsDirect links + backlinks for a note
graph_traverseBFS/DFS from a note, N hops deep with tag filtering
graph_shortest_pathShortest link chain between two notes
graph_analyzeComponents, orphans, bridges, hubs, dead links
Writing & Manipulation
ToolDescription
create_noteCreate with content + frontmatter
patch_noteAppend, prepend, or replace a section. Update frontmatter
move_noteRename/move + auto-update all backlinks across vault
delete_noteDelete + report broken links
manage_tagsAdd/remove/rename tags (vault-wide rename supported)

Configuration

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

{
  "ignore": ["templates/", "daily-notes/", ".trash/"],
  "watchDebounce": 100,
  "maxTraversalDepth": 10,
  "maxSearchResults": 500
}
CLI Flags
--vault <path>       Path to Obsidian vault (required)
--verbose            Enable debug logging
--log-level <level>  error | warn | info | debug (default: info)

How It Works

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

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

Development

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

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.