📓

Obsidian MCP

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

Download .mcpb View on GitHub

What Can Claude Do?

📖

Read Your Notes

Claude can read any note in your vault, including parsed YAML frontmatter as structured data.

🔍

Search Everything

Full-text search across all your notes. Find that thought you had three months ago.

✍️

Create & Update

Claude can create new notes or update existing ones. Great for capturing ideas from conversations.

🚀

Open in Obsidian

Jump straight to any note in Obsidian. Claude can open notes for you to edit.

Installation

Download Bundle Easiest

Download the .mcpb file and open it with Claude Desktop.

Download Latest Release

Via uvx

If you have uv installed, just run:

uvx mcp-obsidian-vault

Manual Config

Add to your Claude Desktop config:

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

Available Tools

list_vaults Discover all Obsidian vaults on your machine

list_notes List all notes in a vault

read_note Read note contents with parsed YAML frontmatter

write_note Create or update a note

search_notes Full-text search across all notes

open_in_obsidian Open a note directly in Obsidian app

How It Works

No plugins. No complex setup. Just your files.

📂

Vault Discovery

Reads obsidian.json to find your vaults automatically

📝

Direct File Access

Your vault is just markdown files. We read and write them directly.

🔗

Native URIs

Uses obsidian:// URLs to open notes in the app

Is It Safe?

🔓

Open Source

All code is on GitHub. Audit it yourself.

🔒

No Network

Nothing leaves your machine. Zero outbound connections.

📁

Minimal Access

Only reads your vault files. Nothing else.

Read full security documentation →

Feedback

Found a bug? Have a feature request? We'd love to hear from you.

Open an Issue