MCP.Market

Obsidian MCP server

by seynurmammad0v·io.github.seynurmammad0v/obsidian-mcp·v1.0.3·1 stars
No reviews yet

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

B75/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B75/100

full report

Adoption
New

1 stars38 downloads/wk

Reviews

Write one

Nobody has reviewed Obsidian MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Obsidian MCP tools (12, 3 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • create_notewrite action

    Create a new note with content and optional frontmatter. Path must end in .md (appended if missing).

  • delete_notewrite action

    Delete a note and report which links will break.

  • graph_analyze

    Structural analysis: connected components, orphan notes, bridge notes, hub notes, or dead links.

  • graph_neighbors

    Get direct [[links]] and backlinks for a note.

  • graph_shortest_path

    Find the shortest link chain between two notes.

  • graph_traverse

    BFS or DFS traversal from a starting note, up to N hops deep. Returns flat node list with depth and edge list.

  • manage_tags

    Add, remove, or rename tags across notes. For add/remove, paths is required. For rename, omit paths for vault-wide.

  • move_note

    Move/rename a note and auto-update all [[wikilinks]] referencing it across the vault.

  • patch_notewrite action

    Surgical edits: append, prepend, or replace a specific section. Can also update frontmatter independently.

  • read_note

    Read a note's full content with parsed frontmatter, links, backlinks, and section headings.

  • search_notes

    Search notes by tags, folder, frontmatter fields, and/or keyword in content. All filters are optional and combinable.

  • vault_stats

    Get an overview of the vault: total notes, tags, links, orphans, components, top tags, and top hubs.

Public scan report

scanner v0.1.10 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan3 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 195 days ago4/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 75/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Obsidian MCP compares

Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
75/100
higher than 40% of 1,297 Productivity servers
Tools
12
the typical Productivity server has 7
Tools that change things
25%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
1
more than 50% of 852 Productivity servers
Downloads a week
38
more than 26% of 423 Productivity servers with a package

What its tools let an agent do: 8 read · 1 create · 2 change · 1 delete

Install Obsidian MCP in Claude Code, Cursor or VS Code

Runs npx -y @smammadov/obsidian-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add obsidian-mcp -- npx -y @smammadov/obsidian-mcp
Add to Cursor

What the publisher says

From the Obsidian MCP repository's README, as published. We do not edit it. Read it on GitHub

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/claudedesktopconfig.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

Graph Traversal

Writing & Manipulation

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

Nothing above is checked by us. What we check is on the safety report.

Obsidian MCP: common questions

Is Obsidian MCP server safe?
Mostly: it is graded B (75/100). Read the Obsidian MCP safety report
How do I install Obsidian MCP?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Obsidian MCP need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Obsidian MCP maintained?
The last commit was 230 days ago (2026-03-17). The latest release is v1.0.3.
What can I use instead of Obsidian MCP?
Servers from other publishers that do the same job: Obsidian Hybrid Search MCP server, DocsAgent — Zotero, Obsidian & Apple Notes MCP Server and Exomem MCP server.
How does Obsidian MCP compare with other Productivity MCP servers?
safety score 75/100 (higher than 40% of 1,297 Productivity servers); tools 12 (the typical Productivity server has 7); tools that change things 25% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Obsidian MCP

Same job from other publishers: the closest match first, then the best rated.

  • Obsidian Hybrid Search
    Search Obsidian vaults with hybrid full-text, fuzzy, semantic, and graph retrieval.
    B
  • DocsAgent — Zotero, Obsidian & Apple Notes MCP Server
    Instant, private access to your knowledge base: Zotero, Obsidian, Apple Notes (macOS).
    B
  • Exomem
    Local Markdown/Obsidian knowledge substrate for MCP agents with governed memory and hybrid search.
    A
  • Seekstone
    Filesystem-direct Obsidian MCP server — search and edit your vault with low context-tax.
    A
  • Obsidian Turbocharged
    Governed Obsidian vault access: hybrid retrieval, Markdown-native memory, HITL confirmations.
    B