obsidian-vault-manager

Obsidian Vault Manager for Claude Code

AI-powered knowledge management plugin for Obsidian vaults using Claude Code

What This Plugin Does

This plugin supercharges your Obsidian vault with AI-powered automation through Claude Code:

• 📝 Universal Content Capture - Save YouTube videos, GitHub repos, web articles, and quick ideas with a single command
• 🏷️ AI Auto-Tagging - Automatically categorize notes using smart tags (no manual tagging needed)
• 📚 Study Guide Generation - Turn any content into structured learning materials
• 🔍 Semantic Search - Find notes by meaning, not just keywords
• 🌐 GitHub Pages Publishing - Publish notes to the web with password protection
• 🎯 Smart Templates - Pre-built templates for videos, articles, ideas, and repositories

See Full Feature List & Examples →

---

Complete Setup Guide

For the complete end-to-end setup of the entire KnowledgeFactory system (Claude Code, Obsidian, Docker MCP, this plugin, and publishing), see:

📘 KnowledgeFactory Quick Setup Cheatsheet

The cheatsheet provides a holistic view including:

• All prerequisite installations (Claude Pro/Max, Docker Desktop, Obsidian, Claude Code)
• Complete Obsidian plugin setup (MCP Tools, Terminal, Smart Connections, Templater)
• Docker MCP server configuration with API keys
• GitHub Pages publishing setup
• Three-tier publishing model (Private, Trusted Circle, Public)

This README focuses specifically on plugin installation and commands.

---

Requirements (Install These First!)

Before installing this plugin, you need:

1. Claude Pro or Max Subscription

• Required: Claude Pro ($20/mo) or Claude Max ($50/mo)
• Sign up: claude.ai/upgrade
• Provides access to Claude Code and advanced AI capabilities

2. Desktop Applications

Claude Code

• Download from claude.ai/code
• Install and sign in with Claude Pro/Max account

Obsidian

• Download from obsidian.md/download
• Install, launch once, create or open your vault

Docker Desktop

• Download from docker.com/products/docker-desktop
• Install and start Docker Desktop
• Verify: docker --version

3. Required Obsidian Plugins

Install these in Obsidian → Settings → Community plugins (turn off Safe Mode first):

1. MCP Tools - Core MCP integration (click "Install Server" button after enabling)
2. Local REST API - Auto-installed by MCP Tools, verify it's enabled
3. Terminal - Integrated terminal in Obsidian (by polyipseity)
4. Smart Connections - Semantic search (required for /semantic-search command)
5. Templater - Advanced templates (required for advanced /capture templates)

CRITICAL: After installing MCP Tools + Local REST API:

• Go to Settings → Community plugins → Local REST API → Copy API Key
• Save this key - you'll need it for Docker MCP Obsidian server configuration

4. Docker MCP Servers

Install via Docker Desktop → MCP Toolkit → Catalog:

Required (3):

• GitHub Official (needs API key from github.com/settings/tokens)
• YouTube Transcripts (no API key needed)
• Obsidian (needs Local REST API key from step 3)

Recommended (3):

• Firecrawl (needs API key from firecrawl.dev, 1000 free/month)
• Context7 (no API key needed)
• Fetch (Reference) (no API key needed)

Optional (2):

• Memory (Reference) (no API key needed)
• Perplexity (needs API key from perplexity.ai/settings/api)

After installing servers:

1. Configure API keys in Docker Desktop → MCP Toolkit → My servers (click server → add keys → save & restart)
2. Connect to Claude Code: MCP Toolkit → Clients → Claude Code → Connect
3. Verify all servers show green status

5. System Tools

Required for /publish command:

# macOS
brew install git jq

# Linux
sudo apt install git jq

# Windows
choco install git jq