Is Obsidian MCP Server safe to use?

Obsidian MCP Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install Obsidian MCP Server?

Obsidian MCP Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can Obsidian MCP Server do?

Obsidian MCP Server provides 12 tools: vault_stats, read_note, search_notes, graph_neighbors, graph_traverse and 7 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Obsidian MCP Server?

Obsidian MCP Server is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.

Is Obsidian MCP Server actively maintained?

Obsidian MCP Server is less actively maintained — last commit was 122 days ago. It has 1 GitHub stars.

Obsidian MCP Server

obsidian-mcp

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

1 5.0k/wk 12 tools GitHub npm

No known CVEs

No license

Maintained

Last commit 122d ago

Works with most clients

Transport: stdio

12 tools · ~709 tok

Grade B · 0.4% of 200K ctx

Edit this pageView history

Productivity

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

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

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-seynurmammad0v-obsidian-mcp)](https://mcppedia.org/s/io-github-seynurmammad0v-obsidian-mcp)

Read me

What Obsidian MCP Server does

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

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'obsidian-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

79/100across 5 weighted dimensions

How we score →

0255075100

−21

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked obsidian-mcp against OSV.dev.

Inventory

Tools (12)

Click any tool to inspect its schema.

~709 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Obsidian MCP Server safe to use?: Obsidian MCP Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install Obsidian MCP Server?: Obsidian MCP Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Obsidian MCP Server do?: Obsidian MCP Server provides 12 tools: vault_stats, read_note, search_notes, graph_neighbors, graph_traverse and 7 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Obsidian MCP Server?: Obsidian MCP Server is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.
Is Obsidian MCP Server actively maintained?: Obsidian MCP Server is less actively maintained — last commit was 122 days ago. It has 1 GitHub stars.

Similar servers

Others in productivity

View all →

Sequential Thinking MCP Server93

Dynamic problem-solving through sequential thought chains

87.9k 1

Qmd93

mini cli search engine for your docs, knowledge bases, meeting notes, whatever. Tracking current sota approaches while being all local

27.3k 4

Memory MCP Server93

Persistent memory using a knowledge graph

87.9k 5

com.monday/monday.com92

MCP server for monday.com integration.

412 4

MCP Security Weekly

Get CVE alerts and security updates for Obsidian MCP Server and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Productivity

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

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

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-seynurmammad0v-obsidian-mcp)](https://mcppedia.org/s/io-github-seynurmammad0v-obsidian-mcp)

Read me

What Obsidian MCP Server does

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

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'obsidian-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

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

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:

{
  "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

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

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

License

MIT

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

79/100across 5 weighted dimensions

How we score →

0255075100

−21

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked obsidian-mcp against OSV.dev.

Inventory

Tools (12)

Click any tool to inspect its schema.

~709 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Obsidian MCP Server safe to use?: Obsidian MCP Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install Obsidian MCP Server?: Obsidian MCP Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Obsidian MCP Server do?: Obsidian MCP Server provides 12 tools: vault_stats, read_note, search_notes, graph_neighbors, graph_traverse and 7 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Obsidian MCP Server?: Obsidian MCP Server is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.
Is Obsidian MCP Server actively maintained?: Obsidian MCP Server is less actively maintained — last commit was 122 days ago. It has 1 GitHub stars.