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

Tool	Description
save_note	Create a new note with frontmatter and optional backlinks
append_to_note	Append content to an existing note
append_to_daily	Add content to today's daily note
get_daily_note	Read a daily note (today or a specific date)
list_daily_notes	List recent daily notes with previews
search_vault	Search notes by title and content
list_folders	List all folders in the vault
list_tags	Extract all tags used across the vault
get_note	Read a specific note by path
save_conversation_summary	Save a structured conversation summary with sections for decisions, code, next steps

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