obsidian-mcp-server

# Obsidian MCP Server An [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server that gives Claude Code read/write access to your Obsidian vault. ## Features - **Read & write notes** - Create, edit, and append to markdown files - **Search** - Full-text search across your vault - **Daily notes** - Read or append to daily notes with configurable date format - **Browse** - List files and folders in your vault - **Secure** - Only accesses your configured vault directory ## Installation ### Via pip ```bash pip install obsidian-mcp-server ``` ### Via pipx (recommended for CLI tools) ```bash pipx install obsidian-mcp-server ``` ### From source ```bash git clone https://github.com/bbdaniels/obsidian-mcp-server.git cd obsidian-mcp-server pip install -e . ``` ## Configure Claude Code Add the MCP server to Claude Code: ```bash claude mcp add obsidian -- python3 -m obsidian_mcp.server ``` Or if installed via pipx: ```bash claude mcp add obsidian -- obsidian-mcp ``` Then restart Claude Code. ## First-Time Setup Once configured, tell Claude: > "Configure obsidian vault at /path/to/your/vault" Claude will run `obsidian_configure` to set up the vault path. Your configuration is stored at `~/.config/obsidian-mcp/config.json`. ## Available Tools | Tool | Description | |------|-------------| | `obsidian_configure` | Set vault path and daily notes settings | | `obsidian_status` | Show current configuration and vault stats | | `obsidian_read` | Read a note's contents | | `obsidian_write` | Create or overwrite a note | | `obsidian_append` | Append to a note (optionally under a heading) | | `obsidian_search` | Search notes by content | | `obsidian_list` | Browse vault structure | | `obsidian_daily` | Read/append to daily notes | ## Built-in Prompts The server includes MCP prompts that provide structured workflows for common note-taking patterns. These show up as invocable prompts in Claude Code. | Prompt | Description | |--------|-------------| | …