obsidian-in-a-vat-mcp

# vault-mcp [English](#english) | [中文](#中文) A personal knowledge vault MCP server for Claude Desktop — capture, search, promote, and connect your ideas, all through natural conversation. https://github.com/user-attachments/assets/0ef205a4-0ffc-4a24-a92a-b4acf66377fe --- <a id="english"></a> ## English Personal knowledge vault MCP server for Claude Desktop. Capture thoughts, search notes, and read files from a local markdown-based knowledge vault. --- ### Quick Start (uvx — Recommended) The lightest way to run vault-mcp. No Docker, no manual venv — just [uv](https://docs.astral.sh/uv/getting-started/installation/) and one config change. **Step 1.** Install uv (if you don't have it): ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` **Step 2.** Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`): ```json { "mcpServers": { "vault": { "command": "uvx", "args": ["obsidian-in-a-vat-mcp"], "env": { "VAULT_LOCAL_PATH": "/Users/yourname/my-vault" } } } } ``` Replace `/Users/yourname/my-vault` with the absolute path to your local vault directory. **Step 3.** Fully quit and reopen Claude Desktop. The `vault` tools will appear automatically. > **Don't have a vault yet?** Just point `VAULT_LOCAL_PATH` to an empty directory. On first use, ask Claude to _"initialize my vault"_ — it will set up the full directory structure automatically. > > **Already have an Obsidian vault?** Point `VAULT_LOCAL_PATH` to your existing vault and ask Claude to _"initialize my vault"_. It will scan your notes, classify them (captures vs. notes), and migrate everything into the vault-mcp format. Originals are safely archived under `_archive/`. --- ### Alternative Setup (Docker) If you prefer Docker: ```json { "mcpServers": { "vault": { "command": "docker", "args": [ "run", "-i", "--rm", "-v", "/Users/yourname/my-vault:/vault", "ghcr.io/o…