v0.1.0 — Initial Release

obsidian-mcp-server v0.1.0

MCP server for Obsidian vaults with direct filesystem access and git sync. No Obsidian required.

9 MCP Tools

Tool	Description
read_note	Read content, frontmatter, tags, and file metadata
create_note	Create notes with optional YAML frontmatter
update_note	Replace, append, or prepend content; merge frontmatter
delete_note	Safe delete to .trash/ or permanent
search_vault	Full-text and regex search with timeout protection
list_vault	Browse vault structure with recursive listing
manage_tags	Add, remove, or list tags from frontmatter
daily_note	Get, create, or append daily notes by date
git_sync	Git operations: status, commit, pull, push, sync, init, log, diff, remotes

Highlights

• No Obsidian required — reads and writes markdown files directly on disk
• Git sync — optional auto-commit+push after every write with configurable debounce
• Robust security — path traversal prevention with symlink resolution, atomic writes, no shell injection
• YAML frontmatter — full parse/serialize support with tag extraction (frontmatter + inline #tags)

Quick Start

npm install && npm run build

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": ["/path/to/obsidian-mcp-server/build/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}