mcp-obsidian-vault 0.3.0

Claude Desktop MCP server for Obsidian vaults

Obsidian MCP

Give Claude Desktop access to your Obsidian vault. No plugins required.

Install the extension, and Claude can read your notes, search them, and create new ones.

Installation

Option 1: mcpb bundle (recommended)

Download obsidian-mcp.mcpb from releases and open it with Claude Desktop.

Option 2: uvx

uvx mcp-obsidian-vault

Option 3: Manual config

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": ["mcp-obsidian-vault"]
    }
  }
}

Tools

Tool	Description
list_vaults	List all Obsidian vaults on your machine
list_notes	List all notes in a vault
read_note	Read note contents
write_note	Create or update a note
search_notes	Full-text search across notes

How It Works

No plugins required — we use Obsidian's native interfaces:

What	How
Find vaults	Read obsidian.json (Obsidian stores vault paths here)
Read/write notes	Direct filesystem access (your vault is just markdown files)
Search	Full-text search with inverted index

Status

Phase	What	Status
1	Vault discovery	✅ Done
2	Read/write notes	✅ Done
3	Search	✅ Done
4	URI integration	Planned
5	PyPI release	✅ Done
6	mcpb bundle	✅ Done

Documentation

Document	What's Inside
CLAUDE.md	Development approach, current status
docs/	Architecture diagrams, roadmap

Contributing

Check the issues if you want to help.

License

MIT