Obsidian MCP Server

obsidian-mcp-server

A Go Model Context Protocol (MCP) server for Obsidian vaults. It gives AI agents and development tools direct filesystem access to your vault — no running Obsidian instance required.

Features

• Read, write, and list notes and directories via MCP tools
• Frontmatter — parse and update YAML frontmatter with format-preserving rewrites
• Tags — extract inline #tags, aggregate vault-wide tag counts, add/remove tags
• Backlinks — on-demand reverse link graph (wikilinks and markdown links)
• Mutations — heading-anchored patch, safe delete, and move with confirmation guards
• Full-text search — BM25 Okapi ranked search with match snippets
• Regex/glob search — RE2 regex or filepath glob search across paths and content
• Path security — 4-layer validation: lexical checks, ignore/extension filters, case-insensitive existence lookup, and symlink escape prevention
• Stdio transport — works with any MCP client (Claude Code, Claude Desktop, etc.)
• Streamable HTTP transport (optional) — TLS 1.3 + bearer token auth by default, loopback-only unless explicitly widened; see --transport http in Configuration and SECURITY.md § HTTP transport
• Zero Obsidian dependency — operates on the vault directory directly
• Token counting — responses include approximate token counts (cl100k_base)

MCP Tools

Shortened. The full README is on GitHub.