Obsidian MCP Server

An MCP server that lets Claude save conversations, notes, and structured summaries directly to your Obsidian vault.

Features

• Save notes with YAML frontmatter and auto-generated backlinks

• Daily notes - append to today's daily note or browse past ones

• Conversation summaries - structured templates with decisions, code snippets, next steps

• Vault search - search notes by title and content

• Auto-backlinks - detects existing notes and inserts [[wiki-links]] automatically

• Path security - all file operations validated within vault boundary

Installation

Requires Python 3.10+.

# Clone the repo
git clone <repo-url>
cd obsidian-mcp

# Install with uv (recommended)
uv pip install -e .

# Or with pip
pip install -e .

Configuration

Environment variable

Set OBSIDIAN_VAULT_PATH to your vault's root directory:

export OBSIDIAN_VAULT_PATH="$HOME/Documents/MyVault"

Defaults to ~/Documents/ObsidianVault if not set.

Claude Code

Add to your Claude Code MCP config (~/.claude/claude_code_config.json or project .mcp.json):

{
  "mcpServers": {
    "obsidian": {
      "command": "obsidian-mcp",
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

Or if running from source without installing:

{
  "mcpServers": {
    "obsidian": {
      "command": "python",
      "args": ["/path/to/obsidian-mcp/obsidian_mcp.py"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

Tools

Vault structure

The server creates notes in this structure:

YourVault/
  Claude Conversations/
    2025-01-30 - Building MCP Server.md
    ProjectName/
      2025-01-30 - Feature Work.md
  Daily Notes/
    2025-01-30.md