AgentToolHub
Skill

obsidian

obsidian — a Claude Code skill from bitbonsai/mcp-obsidian

Features

  • ✓✅ Safe frontmatter parsing and validation using gray-matter with AST-aware updates that preserve raw formatting for unmodified fields
  • ✓✅ Path filtering to exclude `.obsidian` directory and other system files
  • ✓✅ **Complete MCP toolkit**: 14 methods covering all vault operations
  • ✓✅ Write modes: `overwrite`, `append`, `prepend` for flexible content editing
  • ✓✅ Tag management: add, remove, and list tags in notes
  • ✓✅ Safe deletion with confirmation requirement to prevent accidents
  • ✓✅ Automatic path trimming to handle whitespace in inputs
  • ✓✅ TypeScript support with Node.js runtime (using tsx for execution)
  • ✓✅ Comprehensive error handling and validation
  • ✓✅ **Token-optimized responses**: 40-60% smaller responses with minified field names and compact JSON (v0.6.3+)
  • ✓✅ **Optional pretty-printing**: Set `prettyPrint: true` for human-readable debugging
  • ✓✅ **Performance optimized**: No unnecessary token consumption, efficient for large vaults
  • ✓✅ **Zero dependencies**: No Obsidian plugins required, works with any vault structure

Installation Guide

For End Users (Recommended)

No installation needed! Use npx to run directly:

bash
npx @bitbonsai/mcpvault@latest /path/to/your/obsidian/vault

If you omit the vault path, the server uses your current working directory as the vault root.

For Developers

  • Clone this repository

  • Use the correct Node.js version:

    • bash
    nvm use  # Uses Node 24 from .nvmrc

  • Install dependencies with npm:

    • bash
    npm install  # Corepack automatically uses npm 10.9.0

  • Test locally with MCP inspector:

    • bash
    npx @modelcontextprotocol/inspector npm start /path/to/your/vault

    Pro tip: Use MCP Inspector to test all server functionality before configuring with AI clients:

    bash
    # Install globally for easier access
npm install -g @modelcontextprotocol/inspector

# Test with any vault
mcp-inspector npx @bitbonsai/mcpvault@latest /path/to/your/vault

    Reviews